Generazione di immagini

Un unico flusso per ogni modello di immagini disponibile: scegli un modello, invia una richiesta, leggi la risposta e capisci il prezzo.

Modelli di immagini disponibili

0.5K

0,045 USD / immagine

1K

0,067 USD / immagine

2K

0,101 USD / immagine

4K

0,151 USD / immagine

image input

8,00 USD / 1M token

cached image input

2,00 USD / 1M token

generated image output

30,00 USD / 1M token

image input

8,00 USD / 1M token

cached image input

2,00 USD / 1M token

generated image output

30,00 USD / 1M token

image input

8,00 USD / 1M token

cached image input

2,00 USD / 1M token

generated image output

30,00 USD / 1M token

image input

8,00 USD / 1M token

cached image input

2,00 USD / 1M token

generated image output

30,00 USD / 1M token

image input

8,00 USD / 1M token

cached image input

2,00 USD / 1M token

generated image output

30,00 USD / 1M token

image input

8,00 USD / 1M token

cached image input

2,00 USD / 1M token

generated image output

30,00 USD / 1M token

per generation request

0,02 USD / immagine

per generated image

0,02 USD / immagine

1K

0,06 USD / immagine

2K

0,08 USD / immagine

per generated image

0,025 USD / immagine

image input

2,00 USD / 1M token

generated image output

120,00 USD / 1M token

image input

2,00 USD / 1M token

generated image output

120,00 USD / 1M token

image input

0,50 USD / 1M token

generated image output

60,00 USD / 1M token

Richiesta

POST /v1/images/generations. Il percorso e i parametri facoltativi vengono dalla specifica verificata del modello scelto.

curl -sS https://api.oneprovider.dev/v1/images/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A quiet observatory above the clouds",
"size": "1024x1024",
"quality": "low"
}'

Le funzioni cambiano da modello a modello

Dimensioni, livelli di qualità, trasparenza, modifica e formati di risposta dipendono dal modello. Non copiare i parametri facoltativi di un modello su un altro senza verificare che siano supportati.

Risposta

Un transport sincrono restituisce subito i dati dell'immagine o un URL. Un transport asincrono restituisce un id del job; controlla il percorso dello stato, poi scarica dal percorso del contenuto.

Prezzi

La tabella condivisa dei modelli separa ogni tariffa dei token nella propria colonna e mostra il costo per immagine o altri media nella colonna dei media. Apri i prezzi .

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .