FLUX 3 Image Klein

Esempio rapido

Invia una richiesta immagine, salva l’id restituito e interroga finché l’attività non è completed o failed. L’API usa attività asincrone e output tramite URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

Endpoint e intestazioni

POST https://api.seedrouter.ai/v1/images/generations

Conserva la chiave sul server. Un successo HTTP conferma un’attività, non che l’immagine sia pronta.

Parametri

Sono accettati 11 campi. Solo model e prompt sono obbligatori. Ometti gli opzionali per i valori predefiniti; null non è accettato.

Proporzioni: auto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21.

Il Playground ha un modello fisso e dieci controlli, incluso n fissato a 1. Salvo per gli amministratori, valori di sicurezza oltre 2 sono solo per API.

Modalità e vincoli

Senza riferimenti si genera da testo. Un riferimento abilita la modifica; più riferimenti consentono composizioni da varie immagini. Con auto, la modifica segue le proporzioni del primo riferimento. La generazione solo testuale sceglie il formato dal prompt e ripiega su 1:1 se non lo determina. La risoluzione predefinita è 1k in ogni modalità.

I livelli indicano una scala approssimativa: 768sq è circa 768 × 768; 1K circa 1 MP; 1.5K circa 2 MP; 2K circa 4 MP; 4K circa 16 MP. Controlla le dimensioni effettive nel file restituito.

L’endpoint non accetta width, height, dimensioni in pixel in size, negative_prompt, guidance, grounding, prompt_upsampling, mask o mask_url. I campi sconosciuti restituiscono HTTP 400 prima dell’addebito. Non sono offerti output WebP, input base64, streaming o callback.

Immagini di riferimento e modifiche per area

Carica i riferimenti su un URL pubblico prima dell’invio. Il corpo contiene URL, mai byte di file o data URL.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

Sostituisci gli URL di esempio con immagini tue accessibili. I riferimenti sono ordinati: ref_image_0 è il primo. Le istruzioni dei riquadri appartengono alla stringa prompt, non a un campo separato. Le coordinate usano [y1, x1, y2, x2], normalizzate a 0–1000. Un oggetto di layout può contenere id, bbox e desc; una modifica può usare id, from, src_bbox, tgt_bbox e desc. Codifica l’intera richiesta in JSON per gestire correttamente l’escape delle virgolette nel prompt.

Fatturazione

Una richiesta riuscita produce un’immagine. Solo la risoluzione scelta determina il prezzo; passaggi, seed, proporzioni, numero di riferimenti e formato non aggiungono costi. Generazione testuale e modifica hanno la stessa tariffa. Le richieste fallite non sono addebitate. Vedi i prezzi live.

Risposta dell’attività e polling

Invio:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

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

Attività completata (URL illustrativo):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

Leggi output.data[0].url. Prevedi fino a dieci minuti per generare, soprattutto a 4K. Il polling è di sola lettura; un timeout del client non autorizza un’altra richiesta a pagamento. Le risposte pubbliche non includono costi o saldi del conto.

Errori

Gli errori HTTP usano {"error": {"code": integer, "message": string}}. Consulta l’elenco comune degli errori. Un’attività fallita espone l’errore insieme a status: "failed". Correggi i parametri non validi prima di reinviare; conserva l’ID per controllare richieste già inviate.

Suggerimenti e guide correlate

Usa descrizioni positive e indica aree o dettagli da conservare. Meno passaggi possono cambiare la qualità senza ridurre il prezzo. Confronta una modifica alla volta.

• FLUX 3 Image Klein Playground
• Guida a download, pesi e ComfyUI
• Ciclo di vita delle attività