LogoAPI in One
Dashboard

Documentación de la API

Todo lo que necesita para integrar API in One en su aplicación.

Autenticación

Todas las solicitudes de API requieren un token Bearer en el encabezado Authorization. Puede gestionar sus claves API desde el panel de control.

http
Authorization: Bearer aio_your_api_key_here

Obtenga su clave API: Cree su clave API gratuita desde la página de Claves API en su panel de control. Las cuentas nuevas reciben créditos de bonificación para explorar la plataforma.

URL Base

https://apiin.one/api/v1

Endpoints de la 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 Solicitud

Todas las solicitudes usan un cuerpo JSON con un campo 'model' obligatorio para especificar qué modelo de IA usar. Los parámetros adicionales varían según el modelo.

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

El parámetro 'model' siempre es obligatorio. Visite la página de documentación de cada modelo para la lista completa de parámetros soportados.

Formato de Respuesta

Tareas Asíncronas (Imagen, Video, Música, Voz)

Para modelos de generación de contenido, la API devuelve un ID de tarea inmediatamente. Consulte el endpoint de estado para verificar cuándo se completa la tarea.

Initial response when task is created.

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

Respuestas Síncronas (Chat)

Las respuestas de chat se devuelven directamente en una sola solicitud, siguiendo el formato compatible con 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
}

Manejo de Errores

Todos los errores devuelven un formato JSON consistente con código de error, mensaje y tipo.

json
{
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}
Status CodeTipoRequeridoDescripción
400invalid_requestOpcionalParámetros de solicitud inválidos. Consulte la documentación del modelo para los campos requeridos.
401authentication_errorOpcionalLa clave API falta, es inválida o fue revocada.
402insufficient_creditsOpcionalSu cuenta no tiene créditos suficientes. Compre más créditos para continuar.
404not_foundOpcionalEl recurso solicitado (tarea, modelo) no fue encontrado.
429rate_limitOpcionalLímite de velocidad excedido. El valor predeterminado es 60 solicitudes por minuto.
500server_errorOpcionalError interno del servidor. Por favor, intente de nuevo después de un breve intervalo.

Inicio Rápido

1. Obtenga su clave API

Regístrese y cree una clave API desde su panel de control. Las cuentas gratuitas incluyen créditos de bonificación.

2. Realice su primera solicitud

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 el estado de la tarea (modelos asíncronos)

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

4. Explore más modelos

Navegue por nuestro directorio de modelos para encontrar el modelo de IA perfecto para su caso de uso.

Ver todos los modelos →

API Tester

Test the API directly from your browser:

Consola de APIPOST