GPT Image 2
OpenAI gpt-image-2 — high-fidelity image generation with strong prompt following and text rendering.
Preço
$0.0065/ chamada
Endpoint
/images/tasks
Forma de entrega
Ciclo de vida das tarefas assíncronas
Disponibilidade
Disponível agora
Documentação da API
Monte e copie a requisição
Escolha as opções que este modelo aceita. O código abaixo é atualizado conforme você escolhe.
https://www.aisplice.store/v1/images/tasksBearer API keyTarefa assíncronaOpçõesSó aparecem as opções publicadas para este modelo.
# Requires curl and jq
API_KEY="${API_KEY:-YOUR_API_KEY}"
# 1. Submit once
SUBMITTED=$(curl --fail-with-body -sS https://www.aisplice.store/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: model-docs-$(date +%s)-$$" \\
-d '{
"model": "GPT Image 2",
"prompt": "A cinematic scene with careful composition",
"size": "1:1",
"resolution": "1K",
"quality": "auto",
"n": 1
}')
TASK_ID=$(printf '%s' "$SUBMITTED" | jq -r '.task_id // .id // empty')
if [ -z "$TASK_ID" ]; then
printf '%s\n' "$SUBMITTED" >&2
exit 1
fi
echo "task_id=$TASK_ID"
# 2. Poll until terminal
while true; do
STATUS_JSON=$(curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY")
STATUS=$(printf '%s' "$STATUS_JSON" | jq -r '.status // empty' | tr '[:upper:]' '[:lower:]')
echo "status=$STATUS"
case "$STATUS" in
completed|succeeded|success) break ;;
failed|failure|cancelled|canceled)
printf '%s\n' "$STATUS_JSON" | jq .
exit 1
;;
esac
sleep 3
done
# 3. Fetch the final result
curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" | jq .- 1Envie a tarefa
- 2Consulte o status
- 3Busque o conteúdo
URLs de mídia públicas são recomendadas em produção. Envie primeiro o arquivo local e depois coloque public_url na requisição do modelo. Evite corpos grandes em Base64.
Ler o guia de uploadReferência de parâmetros
modelIdentificador exato do modelo para esta requisição.
gpt-image-2promptInstrução que descreve o resultado desejado.
sizeProporção ou dimensões da saída.
auto1:13:22:34:33:45:44:516:99:162:11:23:11:321:99:21resolutionRequests the selected resolution natively, then applies professional upscaling only when returned pixels are below the fulfillment threshold.
1K2K4KqualityFaixa de qualidade da saída solicitada.
autolowmediumhighn1imagesOptional reference images for image editing, up to 16.
Ciclo de vida da resposta
Status da tarefa, estados finais e exemplos de resposta com o resultado.
Ciclo de vida da resposta
Status da tarefa, estados finais e exemplos de resposta com o resultado.
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "image.task",
"model": "GPT Image 2",
"status": "queued"
}{
"created": 1720000000,
"data": [
{
"url": "https://media.example/result.png"
}
]
}Aguardando
queued · submitted · in_progress · processing
Sucesso
completed · succeeded · success
Falha
failed · failure · cancelled · canceled
Erros e produção
Regras de novas tentativas, idempotência e a checklist mínima de produção.
Erros e produção
Regras de novas tentativas, idempotência e a checklist mínima de produção.
400 / 422Corrija os campos da requisição ou a opção não suportada; não tente de novo sem alterações.
401Verifique se a chave de API está presente, ativa e enviada como Bearer token.
402O saldo da conta é insuficiente.
409A Idempotency-Key está em processamento ou foi reutilizada com outro corpo.
429Faça backoff de acordo com o Retry-After antes de tentar novamente.
5xxTente novamente com backoff exponencial e mantenha a Idempotency-Key original.
- Mantenha as chaves de API no seu servidor em aplicações mobile e de navegador públicas.
- Defina uma Idempotency-Key única para cada operação assíncrona cobrada.
- Persista o task_id para que as consultas possam ser retomadas após uma reinicialização.
- Use um timeout em toda requisição HTTP e informe o ID da requisição nos relatos ao suporte.
- Leia os metadados atualizados dos modelos em vez de fixar no código os preços e as opções suportadas.
Preço e faixas
Preço por requisição
$0.0065/ chamada
Preço por faixa
Preço base $0.0065
Preço por faixa — o preço final depende das opções solicitadas. Faixas não listadas são cobradas pelo preço base.
- 16:9×1$0.0065
- 1:1×1$0.0065
- 1:2×1$0.0065
- 1:3×1$0.0065
- 21:9×1$0.0065
- 2:1×1$0.0065
- 2:3×1$0.0065
- 3:1×1$0.0065
- 3:2×1$0.0065
- 3:4×1$0.0065
- 4:3×1$0.0065
- 4:5×1$0.0065
- 5:4×1$0.0065
- 9:16×1$0.0065
- 9:21×1$0.0065
- auto×1$0.0065
- 1k×1$0.0065
- 2k×2.138040769231$0.013897
- 4k×2.138040769231$0.013897
- low:2k×1.189673461538$0.007733
- low:4k×1.189673461538$0.007733
- auto:2k×2.138040769231$0.013897
- auto:4k×2.138040769231$0.013897
- medium:2k×2.138040769231$0.013897
- medium:4k×2.138040769231$0.013897
- high:2k×8.586938461538$0.055815
- high:4k×8.586938461538$0.055815
- 1k×1$0.0065
- 2k×2.138040769231$0.013897
- 4k×2.138040769231$0.013897
O preço mostrado aqui é exatamente o que você paga — chamadas com falha são reembolsadas automaticamente.
Modelos relacionados