Sviluppo API

Invia Autorizzazione: Porta YOUR_API_KEY. i cookie del sito web non sono accettati come API Un'attività a pagamento e il permesso chiave richiesto sono controllati su ogni richiesta.

Leggi i modelli, carica un riferimento se necessario, chiedi una citazione, riconosci esplicitamente quella citazione, poi invii con una chiave stabile Idempotency.

Solo la presentazione di generazione consuma crediti di conto. Le quote e le creazioni chiave non consumono crediti. Il provider non riesce a usare il processo di rimborso e di conciliazione esistente. Non inviare una nuova chiave di idempotenza mentre il risultato originale è sconosciuto.

Ogni chiave consente 60 Richieste autentiche per minuto. a 429 La risposta include Retry-After. Key scade all'interno 1–365 giorni e può essere immediatamente revocato.

I riferimenti utilizzano un caricamento a tre passi: dichiara MIME e dimensioni di byte, PUT i byte, poi completa. JPEG, PNG e WebP fino a 10 Utilizzare l'ID di attività restituita; URL di riferimento esterni e altri beni degli utenti non sono accettati.

// Node.js 22+; keep API_KEY on your server.
const base = process.env.API_BASE_URL;
const headers = {
  Authorization: `Bearer ${process.env.API_KEY}`,
  'Content-Type': 'application/json',
};
const modelsResponse = await fetch(base + '/api/v1/models', { headers });
if (!modelsResponse.ok) throw new Error('Read models failed');
const models = await modelsResponse.json();

const draft = {
  "kind": "image",
  "modelPreset": "gpt-image-2",
  "mode": "text-to-image",
  "prompt": "A yellow ceramic mug on a pale blue background",
  "aspectRatio": "1:1",
  "resolution": "1k",
  "outputCount": 1
};
const quoteResponse = await fetch(base + '/api/v1/quotes', {
  method: 'POST', headers, body: JSON.stringify({ draft }),
});
if (!quoteResponse.ok) throw new Error('Quote failed');
const quote = await quoteResponse.json();

// Review quote.quote before submitting. Persist this operation ID first.
const operationId = process.env.OPERATION_ID;
if (!operationId) throw new Error('A stable operation ID is required');
const submitted = await fetch(base + '/api/v1/generations', {
  method: 'POST',
  headers: { ...headers, 'Idempotency-Key': operationId },
  body: JSON.stringify({
    draft: quote.normalizedDraft,
    quoteAcknowledgement: quote.quote,
  }),
});
if (!submitted.ok) throw new Error('Check response before retrying');
const { task } = await submitted.json();
const taskResponse = await fetch(
  base + '/api/v1/generations/' + task.kind + '/' + task.id, { headers },
);
if (!taskResponse.ok) throw new Error('Read task failed');
const detail = await taskResponse.json();
// Poll at two-second intervals until terminal. Download detail.outputs[].downloadUrl
// with the same Authorization header. Never change the ID to retry an unknown outcome.

401• chiave invalidata, scaduta o revocata. 403• Mancanza di permesso o partecipazione a pagamento. 409: conflitto di idempotenza o quota modificata; richiesta e conferma una nuova quota. 422In arrivo invalidità. 429Il limite dei tassi. 503Leggi il codice errore di risposta; non ritirare mai una presentazione pagata con una nuova chiave automaticamente.