Referencia de la API

APIs heredadas y compatibilidad

#Compatibilidad con OpenAI

Todas las rutas aceptan el cuerpo de solicitud de OpenAI — los parámetros específicos del proveedor (anthropic tool_use, gemini thinking_config) se reenvían sin cambios.

El mismo envoltorio de respuesta que OpenAI

El cuerpo de la respuesta coincide exactamente con OpenAI, así que los parsers, la lógica de reintentos y los wrappers de observabilidad escritos para OpenAI siguen funcionando.

Los endpoints de esta página están activos y se facturan como cualquier otro, pero no son la forma recomendada de integrarse. Úsalos cuando un SDK de proveedor existente tenga que seguir funcionando sin cambios, o cuando heredaste una llamada que aún no puedes migrar.

#¿Qué interfaz deberías usar?

Integración nueva

Usa los endpoints /v1 con formato OpenAI de la referencia de la API. Un solo vocabulario para todas las capacidades, y la única interfaz que recibe parámetros nuevos.

SDK de proveedor existente

Usa el reenvío directo correspondiente de abajo. Cambias la URL base y la clave, y conservas el cuerpo de solicitud propio del proveedor.

Llamada heredada

Sigue funcionando. Migra la próxima vez que toques esa parte del código — estas rutas están congeladas, no mantenidas.

#Reenvío directo nativo del proveedor

Aceptan el cuerpo de solicitud propio del proveedor y devuelven su propio formato de respuesta. La autenticación sigue siendo un único encabezado Authorization: Bearer con una clave de esta plataforma — no se usa el esquema de autenticación del proveedor.

Gemini nativo

reenvío directo

Apunta el SDK de Google GenAI a este gateway sin cambiar el código. La forma de la ruta generateContent y el cuerpo de la solicitud son los propios de Gemini.

GET	/v1beta/models	Lista los modelos con el formato del catálogo de Gemini.
POST	/v1beta/models/*	Forma de ruta de Gemini: /v1beta/models/{model}:{action}, p. ej. :generateContent o :streamGenerateContent.
POST	/v1/models/*	El mismo formato de solicitud de Gemini bajo /v1, para clientes que no pueden cambiar el prefijo de versión de la API.
POST	/v1/engines/:model/embeddings	Embeddings de Gemini a través de la ruta heredada engines.

Kling nativo

reenvío directo

Acepta el cuerpo de solicitud oficial de Kling (model_name + prompt y los campos propios del proveedor) y devuelve su formato de tarea.

POST	/kling/v1/videos/text2video	Envía una tarea de texto a video de Kling con el formato de cuerpo propio del proveedor.
POST	/kling/v1/videos/image2video	Envía una tarea de imagen a video de Kling.
GET	/kling/v1/videos/text2video/:task_id	Consulta una tarea de texto a video de Kling.
GET	/kling/v1/videos/image2video/:task_id	Consulta una tarea de imagen a video de Kling.

Jimeng nativo

reenvío directo

API oficial de Jimeng basada en consultas Action. El envío y el resultado comparten una ruta y se eligen con el parámetro Action.

POST	/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31	Envía una tarea con req_key y prompt en el cuerpo del proveedor. La barra final es obligatoria — /jimeng redirige, y un 301 descarta el cuerpo en la mayoría de los clientes HTTP.
POST	/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31	Obtén el resultado de una tarea enviada.

Suno nativo

reenvío directo

Envío y consulta de música con formato Suno. Para trabajo nuevo, prefiere /v1/music/generations — devuelve el formato de tarea de la plataforma que se usa en todo lo demás.

POST	/suno/submit/:action	action es music o lyrics.
POST	/suno/fetch	Consulta por lotes a partir de una lista de id.
GET	/suno/fetch/:id	Consulta una tarea.

gemini-native.sh

# Google GenAI SDK: set the API endpoint, keep everything else.
curl "https://www.aisplice.store/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello."}]}]
  }'

Las respuestas de reenvío directo son del proveedor, no nuestras

Los códigos de estado, los cuerpos de error y los nombres de campo de estas rutas siguen al proveedor upstream. El envoltorio de error de la plataforma y los códigos de error documentados solo se aplican a los rechazos del lado del gateway, como autenticación, cuota y enrutamiento.

#Rutas heredadas congeladas

Se enrutan y se facturan, pero están cerradas a cambios: sin parámetros nuevos, sin garantía de modelos nuevos y sin promesa de compatibilidad más allá de lo que funciona hoy.

Alias heredados

congelado

Siguen enrutándose y facturándose, pero están congelados: sin parámetros nuevos ni garantías de compatibilidad. Migra cuando toques el código que los llama.

POST	/v1/completions	Completions de prompt heredado de OpenAI. Usa /v1/chat/completions.
POST	/v1/edits	A pesar del nombre, se enruta al formato de edición de imágenes. Usa /v1/images/edits.
POST	/v1/video/generations	Envío de video anterior al formato OpenAI. Usa POST /v1/videos.
GET	/v1/video/generations/:task_id	Consulta de video anterior al formato OpenAI. Usa GET /v1/videos/{task_id}.

Archivo de Midjourney

congelado

Solo lectura. El envío de pago a Midjourney se retiró; solo queda la consulta de tareas históricas y sus imágenes archivadas.

GET	/mj/task/:id/fetch	Consulta una tarea archivada.
GET	/mj/task/:id/image-seed	Lee la semilla de una imagen archivada.
GET	/mj/image/:id	Sirve una imagen archivada.

#Qué devuelve 404

Las interfaces de OpenAI no admitidas no se registran en absoluto. Un 404 en una ruta de OpenAI significa que la capacidad realmente no se ofrece aquí — no es una carencia temporal, y no hay ninguna ruta que responda 501 para aparentar lo contrario.

Descubrir a qué puede acceder realmente una clave

GET /v1/models lista todos los modelos que esta clave puede llamar. Combínalo con un 404 en la propia ruta y podrás distinguir "modelo no permitido" de "endpoint no disponible".

¿Sigues con el problema?

Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.

AnteriorFacturación y saldo SiguienteAntes de salir a producción