Guida rapida

Creare una chiave API

Accedi e crea una chiave in Chiavi API. Salvala appena viene mostrata la prima volta. Aggiungi credito in Fatturazione.

Imposta SEEDROUTER_API_KEY nell'ambiente del tuo server. Gli esempi Python richiedono il pacchetto requests.

Inviare un'attività

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

Leggere il risultato

Conserva l'id restituito, poi interrogalo con la chiave API dello stesso account:

curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Ripeti ogni tre secondi finché lo stato è processing. Quando diventa completed, leggi output.data[].url. Se è failed, esamina error.

Un timeout del polling non annulla la generazione. Salva l'identificativo dell'attività e riprendi a interrogarlo invece di inviare un'altra richiesta di generazione.

Vedi Attività per un esempio di polling completo e GPT Image 2 per le opzioni di modifica, qualità e dimensione.