Descripción general de la API de imágenes

APIMaster proporciona API de imágenes bajo https://apimaster.ai/v1. La imagen a imagen no usa un formato de entrada universal en todos los modelos. Elige primero el modelo y luego usa su endpoint documentado y sus campos de referencia.

Guía de modelos y endpoints

Modelo	Texto a imagen	Imagen a imagen	Guía
gpt-image-2	JSON /images/generations	Multipart /images/edits, archivos image / image[]	GPT Image 2 / 2.5
gpt-image-2.5-sunburst	JSON /images/generations	Multipart /images/edits, archivos image / image[]	GPT Image 2 / 2.5
gpt-image-2.5-flare	JSON /images/generations	Multipart /images/edits, archivos image / image[]	GPT Image 2 / 2.5
gemini-3.1-flash-image-preview	JSON /images/generations	JSON /images/generations con image_urls	Gemini Flash Image
gemini-nano-banana-2.1	JSON /images/generations	multipart /images/edits / JSON image_urls	Nano Banana 2.1
grok-imagine-image-2.0	JSON /images/generations	JSON /images/generations con image_urls (hasta 5)	Grok Imagine Image 2.0
doubao-seedream-5-0-pro-260628	JSON /images/generations	JSON /images/generations con image	Seedream 5.0 Pro
midjourney-v8.2	Asíncrono /midjourney/generations	Referencias image_urls en JSON	Midjourney v8.2 / Niji 7
midjourney-niji-7	Asíncrono /midjourney/generations	Referencias image_urls en JSON	Midjourney v8.2 / Niji 7

Para Grok Imagine Image 2.0, usa /images/generations síncrono con image_urls. Las rutas asíncronas del cliente y /images/edits no son compatibles; consulta la guía de Grok Imagine Image 2.0.

Para las imágenes de referencia de GPT, sube archivos reales a /images/edits para obtener una respuesta de imagen o a /images/edits/async para obtener una respuesta de tarea; no copies el formato JSON de Gemini o Seedream. Mencionar referencias en el prompt no es una subida. GPT Image 2.5 es una familia de modelos separada, no un alias de GPT Image 2.

Midjourney v8.2 y Niji 7 crean tareas asíncronas mediante /midjourney/generations; consulta periódicamente GET /tasks/{task_id}. Consulta la guía de Midjourney v8.2 / Niji 7 para ver parámetros y ejemplos.

Autenticación y respuestas

• Crea una clave en la consola; envía Authorization: Bearer YOUR_API_KEY.
• Las llamadas de generación JSON usan Content-Type: application/json. Para ediciones multipart, deja que el cliente HTTP genere el Content-Type y el boundary.
• Las respuestas de imagen síncronas contienen data[] con url o b64_json; maneja ambos formatos. Descarga las URL temporales cuanto antes.
• Los campos opcionales, los límites de referencia, los tamaños y los precios dependen del modelo y de la ruta disponible. Consulta la guía del modelo y el marketplace.

Trabajo asíncrono

POST /images/generations/async, POST /images/edits/async y GET /tasks/{task_id}?model=MODEL_ID proporcionan flujos de trabajo de imágenes basados en tareas para los modelos compatibles. Este no es un modo universal para todas las operaciones de imágenes:

• Para GPT Image 2, Sunburst y Flare, usa JSON generations/async para texto a imagen y multipart edits/async para edición. Sube los mismos archivos que en las ediciones síncronas y luego consulta con la cuenta que hizo el envío y el mismo ID de modelo.
• La generación o la edición pueden terminar antes de que el envío asíncrono devuelva un ID de tarea; no asumas que el envío es instantáneo. No reenvíes una tarea existente mientras la consultas. La finalización puede ser succeeded, success o completed; los resultados rastreados usan un url de tipo cadena, mientras que los resultados heredados pueden contener un array de URL.
• Gemini tiene su propio flujo de generación asíncrona; sigue su guía para las entradas de referencia.
• Seedream 5.0 Pro usa generaciones síncronas y no admite /images/generations/async.

Consulta las guías de los modelos para ver ejemplos completos de cURL/Python, estados de polling y solución de problemas. Una respuesta HTTP 200 por sí sola no verifica la fidelidad de la imagen de referencia.