LogoAPI in One
Dashboard

Documentação da API

Tudo o que você precisa para integrar o API in One ao seu aplicativo.

Autenticação

Todas as requisições da API requerem um token Bearer no cabeçalho Authorization. Você pode gerenciar suas chaves API no painel de controle.

http
Authorization: Bearer aio_your_api_key_here

Obtenha sua chave API: Crie sua chave API gratuita na página de Chaves API do seu painel. Novas contas recebem créditos bônus para explorar a plataforma.

URL Base

https://apiin.one/api/v1

Endpoints da API

POST/api/v1/images/generations
POST/api/v1/videos/generations
POST/api/v1/audio/music
POST/api/v1/audio/speech
POST/api/v1/chat/completions
POST/api/v1/images/tools/remove-bg
GET/api/v1/tasks/{task_id}

Formato de Requisição

Todas as requisições usam corpo JSON com um campo 'model' obrigatório para especificar qual modelo de IA usar. Parâmetros adicionais variam por modelo.

json
{
  "model": "flux-2",
  "prompt": "A beautiful landscape",
  "...other_params": "..."
}

O parâmetro 'model' é sempre obrigatório. Visite a página de documentação de cada modelo para a lista completa de parâmetros suportados.

Formato de Resposta

Tarefas Assíncronas (Imagem, Vídeo, Música, Voz)

Para modelos de geração de conteúdo, a API retorna um ID de tarefa imediatamente. Consulte o endpoint de status para verificar quando a tarefa está concluída.

Initial response when task is created.

{
  "id": "task_abc123",
  "status": "pending",
  "model": "kling-3",
  "created_at": "2026-02-24T12:00:00Z"
}

Respostas Síncronas (Chat)

Respostas de chat são retornadas diretamente em uma única requisição, seguindo o formato compatível com OpenAI.

json
{
  "id": "chatcmpl_xyz",
  "model": "gemini",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 156,
    "total_tokens": 168
  },
  "credits_consumed": 2
}

Tratamento de Erros

Todos os erros retornam um formato JSON consistente com código de erro, mensagem e tipo.

json
{
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}
Status CodeTipoObrigatórioDescrição
400invalid_requestOpcionalParâmetros de requisição inválidos. Verifique a documentação do modelo para campos obrigatórios.
401authentication_errorOpcionalChave API ausente, inválida ou revogada.
402insufficient_creditsOpcionalSua conta não tem créditos suficientes. Compre mais créditos para continuar.
404not_foundOpcionalO recurso solicitado (tarefa, modelo) não foi encontrado.
429rate_limitOpcionalLimite de taxa excedido. O padrão é 60 requisições por minuto.
500server_errorOpcionalErro interno do servidor. Por favor, tente novamente após um breve intervalo.

Início Rápido

1. Obtenha sua chave API

Cadastre-se e crie uma chave API no seu painel. Contas gratuitas incluem créditos bônus.

2. Faça sua primeira requisição

bash
curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer aio_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2",
    "prompt": "A serene Japanese garden with cherry blossoms"
  }'

3. Verifique o status da tarefa (modelos assíncronos)

bash
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer aio_your_key"

4. Explore mais modelos

Navegue pelo nosso diretório de modelos para encontrar o modelo de IA perfeito para seu caso de uso.

Ver todos os modelos →

API Tester

Test the API directly from your browser:

Playground da APIPOST