Referência da API
Use a API aberta do GPT Image 2 para gerar e editar imagens de forma programática. Autentique-se com sua própria chave de API, pague com créditos e obtenha resultados por polling.
Visão geral
A API do GPT Image 2 permite gerar imagens através da sua conta GPT Image 2. As solicitações usam a chave de API do seu site e são roteadas através da nossa integração Kie no lado do servidor.
Crie uma chave de API em:
/settings/apikeysEm seguida, chame:
POST /api/v1/images/generations
GET /api/v1/images/tasks/{task_id}A geração de imagens é assíncrona. O endpoint de criação retorna um id de tarefa, e o endpoint de tarefa retorna as URLs finais da imagem quando a geração é bem-sucedida.
Autenticação
Envie sua chave de API do GPT Image 2 como token Bearer:
Authorization: Bearer sk-xxxNão exponha chaves de API em código do lado do navegador. Use-as a partir do seu backend, scripts ou funções serverless.
Cobrança
O uso da API consome os mesmos créditos que o aplicativo web:
| Operação | Custo em créditos |
|---|---|
| Geração de imagem | 10 créditos por imagem |
Se uma solicitação do provedor falhar antes de uma tarefa ser aceita, os créditos consumidos são reembolsados automaticamente pelo fluxo de falha de tarefa.
Criar geração de imagem
Endpoint
POST https://gpt-image-2.art/api/v1/images/generationsCorpo da solicitação
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
model | string | Não | Use gpt-image-2. Os aliases internos gpt-image-2-text-to-image e gpt-image-2-image-to-image também são suportados. |
prompt | string | Sim | Descrição textual da imagem. Obrigatório a menos que image_urls sejam fornecidas. |
image_urls | string[] | Não | URLs de imagens de referência para geração de imagem para imagem. |
n | integer | Não | Número de imagens a gerar, de 1 a 10. Padrão: 1. |
size | string | Não | Um de 1024x1024, 1536x1024, 1024x1536, 1920x1088, 1088x1920, 3824x2160, 2160x3824 ou auto. |
quality | string | Não | Opção de qualidade do provedor, por exemplo high ou auto. |
output_format | string | Não | png, jpeg ou webp quando suportado pelo provedor. |
response_format | string | Não | Apenas url é suportado. |
user | string | Não | Identificador opcional do usuário final para seu próprio rastreamento. |
Exemplo de texto para imagem
curl https://gpt-image-2.art/api/v1/images/generations \
-H "Authorization: Bearer $GPT_IMAGE_2_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A cinematic product photo of a matte black coffee bag on a marble counter",
"size": "1536x1024",
"quality": "high",
"n": 1
}'Exemplo de imagem para imagem
curl https://gpt-image-2.art/api/v1/images/generations \
-H "Authorization: Bearer $GPT_IMAGE_2_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Keep the product unchanged and place it on a clean studio background",
"image_urls": ["https://example.com/product.png"],
"size": "1024x1024",
"n": 1
}'Resposta de criação
{
"id": "8f6d9f87-1b3f-4f89-bdfb-3df8e77b7af3",
"object": "image.generation",
"created": 1714000000,
"model": "gpt-image-2-text-to-image",
"status": "pending",
"credits": 10,
"data": []
}Salve o id e faça polling no endpoint de tarefa.
Consultar tarefa de imagem
Endpoint
GET https://gpt-image-2.art/api/v1/images/tasks/{task_id}Exemplo
curl https://gpt-image-2.art/api/v1/images/tasks/8f6d9f87-1b3f-4f89-bdfb-3df8e77b7af3 \
-H "Authorization: Bearer $GPT_IMAGE_2_API_KEY"Resposta de sucesso
{
"id": "8f6d9f87-1b3f-4f89-bdfb-3df8e77b7af3",
"object": "image.generation",
"created": 1714000000,
"model": "gpt-image-2-text-to-image",
"status": "succeeded",
"credits": 10,
"data": [
{
"url": "https://..."
}
]
}Valores possíveis de status:
| Status | Significado |
|---|---|
pending | A tarefa está na fila. |
processing | O provedor está gerando a imagem. |
succeeded | As URLs de imagem estão disponíveis em data. |
failed | A geração falhou. |
canceled | A geração foi cancelada. |
Exemplo em JavaScript
const apiKey = process.env.GPT_IMAGE_2_API_KEY;
const createRes = await fetch(
'https://gpt-image-2.art/api/v1/images/generations',
{
method: 'POST',
headers: {
Authorization: `Bearer ${apiKey}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'gpt-image-2',
prompt:
'A premium skincare bottle on wet stone with soft studio lighting',
size: '1024x1024',
n: 1,
}),
}
);
const task = await createRes.json();
let result = task;
while (['pending', 'processing'].includes(result.status)) {
await new Promise((resolve) => setTimeout(resolve, 3000));
const queryRes = await fetch(
`https://gpt-image-2.art/api/v1/images/tasks/${task.id}`,
{
headers: {
Authorization: `Bearer ${apiKey}`,
},
}
);
result = await queryRes.json();
}
console.log(result.data);Formato de erro
Os erros seguem o formato de estilo OpenAI:
{
"error": {
"message": "Invalid API key provided.",
"type": "authentication_error",
"param": null,
"code": "invalid_api_key"
}
}Recursos relacionados
- Preços e créditos — Custo de créditos por chamada e pacotes
- Guia de prompts — Obtenha melhores resultados via API
- Casos de uso — Padrões reais de integração de API
- Galeria de exemplos — Veja o que o GPT Image 2 pode fazer
- Documentação oficial da OpenAI Image API — Referência oficial para usuários com sua própria chave OpenAI