Pro API: gestisci il rendering cloud dal tuo server

Tutto ciò che l'app fa online (immagini, ritocchi, video, personaggi addestrati) è raggiungibile anche via HTTP, allo stesso prezzo in crediti, senza che l'app sia aperta. Lo gestisci dal tuo server, dai tuoi script o dal tuo agente, usando i crediti della tua licenza.

Disponibile con la licenza Pro. La chiave viene creata nell'app, in Impostazioni > API.


Base	`https://api.tendre.ai/pro/v1`
Autenticazione	header `Authorization: Bearer tk_pro_...`
Formato	JSON in ingresso e in uscita, PNG per le immagini, MP4 per i video
Descrizione della macchina	openapi-pro.yaml (OpenAPI 3.0), per generare un client

Ottieni una chiave

Nell'app, con una licenza Pro: Impostazioni > API > Nuova chiave. Dagli un nome (ad esempio "server di produzione"), scegli i permessi e, se vuoi, un limite giornaliero di crediti e una data di scadenza.

La chiave viene mostrata una sola volta. Copiala subito. Una chiave persa si sostituisce, non si recupera.

Al massimo tre chiavi attive per licenza. Abbastanza per ruotarne una senza interrompere il servizio: crea la nuova, installala, revoca la vecchia.
Una chiave non è un posto. Il tuo computer e il tuo telefono restano utilizzabili insieme ad essa.
Una chiave vale quanto i tuoi crediti. Non metterla mai in una pagina web, un'app distribuita o un repository pubblico. Impostale un limite giornaliero di crediti non appena vive su un server.

Cosa può fare una chiave

Permesso	Cosa consente
Lettura	Sempre concesso: stato del rendering, download dei file, saldo, lista dei personaggi
Immagini	Inviare e annullare immagini (generazione, ritocco, variazione)
Video	Inviare e annullare video

Una chiamata oltre i permessi della chiave restituisce 403 portee_manquante, con il permesso mancante in portee.

Il ciclo di vita del rendering

Sempre gli stessi tre passi.

Invia. POST /images o POST /videos. Risposta immediata con un jobId e il costo.
Controlla. GET /images/{jobId} o GET /videos/{jobId}, ogni 3 secondi, finché status non è completed o failed.
Scarica. GET /images/{jobId}/file o GET /videos/{jobId}/file, non appena lo stato è completed. Il file non viene conservato, quindi scaricalo senza aspettare.

Tempi indicativi: da 10 a 40 secondi per un'immagine, da 1 a 5 minuti per un video, di più quando il motore parte da freddo.

La tua prima chiamata

KEY=tk_pro_...
B=https://api.tendre.ai/pro/v1
curl -s $B/credits -H "Authorization: Bearer $KEY"

{ "balance": 1830, "licenseId": "lic_...", "key": "k_1a2b3c4d",
  "limits": { "concurrent": 2, "perMinute": 60, "perDay": 0 }, "running": 0 }

Se risponde, tutto il resto funzionerà.

Un rendering completo, in tre modi

bash

KEY=tk_pro_...
B=https://api.tendre.ai/pro/v1
JOB=$(curl -s $B/images -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"prompt":"a lighthouse at dawn, photorealistic","width":1216,"height":832}' | jq -r .jobId)
until curl -s $B/images/$JOB -H "Authorization: Bearer $KEY" | grep -q '"completed"'; do sleep 3; done
curl -s $B/images/$JOB/file -H "Authorization: Bearer $KEY" -o lighthouse.png

PowerShell

$H = @{ Authorization = "Bearer tk_pro_..." }
$B = "https://api.tendre.ai/pro/v1"
$job = Invoke-RestMethod -Uri "$B/videos" -Method Post -Headers $H -ContentType "application/json" `
  -Body '{"prompt":"waves on a beach at sunset, gentle wind","width":1080,"height":1920,"audio":true}'
do { Start-Sleep 5; $s = Invoke-RestMethod -Uri "$B/videos/$($job.jobId)" -Headers $H } while ($s.status -eq "pending")
Invoke-WebRequest -Uri "https://api.tendre.ai$($s.file_url)" -Headers $H -OutFile beach.mp4

Python

import time, requests
KEY, B = "tk_pro_...", "https://api.tendre.ai/pro/v1"
H = {"Authorization": f"Bearer {KEY}"}
job = requests.post(f"{B}/videos", headers=H, json={"prompt": "waves on a beach at sunset, gentle wind", "audio": True}).json()
while (s := requests.get(f"{B}/videos/{job['jobId']}", headers=H).json())["status"] == "pending":
    time.sleep(3)
if s["status"] == "completed":
    open("beach.mp4", "wb").write(requests.get("https://api.tendre.ai" + s["file_url"], headers=H).content)
else:
    print("failed:", s.get("detail"))

Dove andare dopo

Immagini: generazione, tre modalità di ritocco, personaggi.
Video: formati, griglia dei prezzi, fotogrammi iniziali e finali.
Account: saldo, limiti, personaggi addestrati, attività.
Limiti ed errori: limiti, ogni codice di errore, buone pratiche.

Cosa non c'è ancora

Nell'ordine previsto: addestramento dei personaggi dalle tue foto, voci, upscaling a 2K, un seed fisso per riprodurre un rendering, e webhook per smettere di fare polling.

Le API sono versionate. Tutto ciò che è descritto qui rimane valido sotto /pro/v1: le aggiunte non rompono mai ciò che esiste, e una modifica incompatibile verrebbe rilasciata come /pro/v2.