Chave de API do GPT Image 2: acesso e primeira requisição

Sim, o GPT Image 2 tem API, e na SeedRouter uma única chave de API dá acesso a ela. Entre na sua conta, crie uma chave na página de chaves de API, adicione créditos na página de cobrança e envie a chave em um cabeçalho Authorization: Bearer para https://api.seedrouter.ai/v1/images/generations. A chave aparece completa só uma vez, quando você a cria, então copie-a direto para o ambiente do seu servidor.

Os passos abaixo levam você de nenhuma conta até uma imagem pronta e cobrem os quatro erros que barram a maioria das primeiras requisições.

Como obter uma chave de API do GPT Image 2?

Entre na SeedRouter com sua conta Google.
Abra chaves de API e crie uma chave. Dê a ela um nome que diga onde vai rodar, como production-server.
Copie a chave imediatamente. Depois desta tela você só vê uma versão mascarada, e uma chave perdida não pode ser recuperada. Nesse caso, revogue-a e crie uma nova.
Adicione créditos na página de cobrança. A chave funciona assim que é criada, mas uma requisição precisa de créditos para rodar.

Uma chave dá acesso a todos os modelos da SeedRouter, então você não precisa de uma chave separada para o GPT Image 2 e o GPT Image 2.5. Em vez disso, crie chaves separadas por ambiente. Assim, revogar a chave de staging não tem como derrubar a produção.

Onde a chave de API deve ficar?

No seu servidor, em uma variável de ambiente, e em nenhum outro lugar:

export SEEDROUTER_API_KEY="your-key"

Nunca coloque a chave em JavaScript do navegador, no pacote de um app mobile ou em um repositório público. Qualquer pessoa que a leia pode gastar seus créditos. Se o seu produto tem front-end, faça-o chamar o seu próprio back-end e deixe o back-end chamar a API com a chave.

Se uma chave vazar, revogue-a na página de chaves de API na mesma hora. Uma chave revogada para de funcionar, e as requisições que a usam são rejeitadas.

Como fazer a primeira requisição com a chave?

Envie a chave como bearer token. A resposta é uma referência de tarefa, não a imagem:

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

Salve o id da resposta e consulte GET https://api.seedrouter.ai/v1/tasks/{id} com o mesmo cabeçalho até status ser completed. A tarefa concluída lista as URLs das imagens. Para o fluxo completo em código, veja a API do GPT Image 2 em Python.

Dois IDs de modelo servem o GPT Image 2 com os mesmos campos: gpt-image-2 cobra um preço fixo por imagem entregue, e gpt-image-2-official cobra os tokens que cada renderização informa. A chave funciona com os dois. Os preços atuais estão na página do modelo.

Quais erros uma chave de API nova costuma encontrar?

Código de erro	HTTP	O que significa	O que fazer
`10001`	401	A chave está ausente, digitada errado ou revogada	Envie a chave completa no cabeçalho `Authorization`
`20002`	400	O valor de `model` não é um ID disponível	Use exatamente `gpt-image-2` ou `gpt-image-2-official`
`20001`	400	Um campo está errado; a mensagem o indica quando possível	Corrija esse campo antes de tentar de novo
`30001`	402	A conta ficou sem créditos	Adicione créditos e reenvie

Dois deslizes causam a maioria das falhas na primeira requisição. Um é a chave colada com um caractere faltando ou um espaço sobrando, o que retorna 10001. O outro é copiar o nome do modelo de um título, como gpt-image-2.0 ou GPT Image 2, em vez do ID do modelo, o que retorna 20002. Os dois são rejeitados antes de qualquer trabalho começar, então nada é cobrado.

Existe chave de API do GPT Image 2 grátis?

Não. Criar a chave é grátis, mas as requisições são pagas com créditos pré-pagos. O que você não paga é a falha: uma tarefa que termina como failed, ou que não retorna imagem, não custa nada. Os créditos são comprados como recargas únicas, nunca expiram e não envolvem assinatura, então uma primeira recarga pequena basta para testar uma integração direito.

Dá para usar a mesma chave em Python e JavaScript?

Sim. A chave é uma string em um cabeçalho HTTP, então qualquer linguagem capaz de enviar uma requisição HTTP pode usá-la. Leia-a do ambiente em cada runtime: os.environ["SEEDROUTER_API_KEY"] em Python e process.env.SEEDROUTER_API_KEY em Node.js. Mantenha o JavaScript no lado do servidor; a mesma chave em código de navegador fica exposta a todos os visitantes.

Perguntas frequentes

Preciso de uma chave de API da OpenAI para usar o GPT Image 2 aqui?

Não. Sua chave da SeedRouter é a única credencial que você envia. Você não cria nem gerencia uma conta separada em outro lugar para chamar o GPT Image 2 por esta API.

Quantas chaves de API posso criar?

O suficiente para uma por servidor ou serviço; o limite por conta fica muito acima do que uma integração precisa. Cada chave pode ser revogada individualmente.

Onde vejo quanto uma chave gastou?

No histórico de uso. Cada requisição mostra o modelo e a cobrança, o que facilita comparar uma integração nova com a sua estimativa.

Mantenha a chave no servidor e coloque no ar

Crie uma chave por ambiente, guarde-a em uma variável de ambiente e envie-a como bearer token apenas a partir do seu back-end. Quando a primeira requisição retornar um id de tarefa, a parte do acesso está resolvida; todo o resto está na referência da API do GPT Image 2.

Chave de API do GPT Image 2: como obter acesso e fazer a primeira requisição