ShareAI Platform Docs

Generar imágenes

La respuesta JSON sincrónica contiene resultados de imágenes en los datos.

Ver como Markdown
En esta página
POST https://api.shareai.now/api/v1/images

Generar imágenes

URL base
https://api.shareai.now
Autenticación
Clave API Bearer o token de acceso OAuth aprobado
Alcance requerido
inference or monetization_gateway

La respuesta JSON sincrónica contiene resultados de imágenes en data. El alias /api/v1/images/generations también es compatible. Opciones como tamaño, resolución, relación de aspecto, calidad y formato de salida dependen del modelo seleccionado. Las respuestas están limitadas a 2 MiB; reduzca la cantidad o el tamaño de las imágenes cuando sea necesario. Las imágenes devueltas están limitadas a 8192 píxeles por lado.

Antes de comenzar#

Configure SHAREAI_API_KEY en su servidor y reemplace el marcador de posición del modelo con un modelo actualmente habilitado. Nunca exponga la clave API en el código del navegador. El modelo, la cuenta, las credenciales y el proveedor deben permitir esta operación. Las configuraciones opcionales a continuación requieren soporte del modelo; los límites de seguridad de la API no garantizan que todos los modelos admitan todos los valores.

Envía una solicitud#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_IMAGES_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1
}'

Campos de solicitud#

CampoTipoSignificado y límites
model requeridocadenaIdentificador exacto de modelo público habilitado. Debe declarar esta operación y estar permitido por sus credenciales.
prompt requeridocadenaIndicador de generación no vacío, de un máximo de 256 KiB de texto UTF-8.
nenteroCantidad opcional de imágenes, 1–10; por defecto 1. Su modelo puede permitir menos.
sizecadenaTamaño de salida compatible con el modelo, de un máximo de 100 caracteres, por ejemplo 1024×1024. No todos los modelos admiten esta opción.
resolutioncadenaSelector de resolución compatible con el modelo, de un máximo de 100 caracteres; debe coincidir con la variante de tarifa publicada.
aspect_ratiocadenaSelector de relación de aspecto compatible con el modelo, de un máximo de 100 caracteres.
qualitycadenaSelector de calidad compatible con el modelo, de un máximo de 100 caracteres; puede seleccionar una tasa diferente.
response_formatcadenaFormato de respuesta admitido por el modelo, con un máximo de 100 caracteres. La operación determina si el resultado es JSON o binario.
output_formatcadenaSelector de codificación de salida compatible con el modelo, de un máximo de 100 caracteres.
backgroundcadenaConfiguración opcional de fondo de imagen cuando sea compatible con el modelo.
seedenteroSemilla opcional compatible con el modelo. El video requiere un número entero no negativo; la reproducibilidad depende del ejecutor.
input_referencesmatrizUn máximo de 16 partes de image_url tipificadas con image_url.url configurado en una URL HTTPS o una URL de datos de imagen compatible. Se requiere compatibilidad con el modelo.
providerobjetoPreferencias opcionales de enrutamiento del proveedor. Use provider.only para etiquetas de proveedor aceptadas, no como prefijo en el ID del modelo. Las restricciones de cuenta y credenciales aún se aplican.

Leer el resultado#

El éxito devuelve HTTP 200 con JSON. La respuesta JSON sincrónica contiene resultados de imágenes en data. El alias /api/v1/images/generations también es compatible. Opciones como tamaño, resolución, relación de aspecto, calidad y formato de salida dependen del modelo seleccionado. Las respuestas están limitadas a 2 MiB; reduzca la cantidad o el tamaño de las imágenes cuando sea necesario. Las imágenes devueltas están limitadas a 8192 píxeles por lado.

Unidades de facturación#

Las tarifas de imágenes pueden usar imágenes generadas, megapíxeles medidos, referencias de entrada, solicitudes o tokens reportados por el proveedor. Una URL de imagen no es una medida del tamaño de la imagen. Las tarifas por megapíxeles requieren dimensiones de imagen devueltas; use la salida en base64 para esas rutas.

Elija el identificador exacto del modelo habilitado desde la Consola. Su operación declarada y capacidades de entrada/salida deben coincidir con este endpoint; un modelo de chat de texto no puede sustituirse por otra operación. Sus restricciones de credenciales, proveedor y cuenta aún se aplican.

Precios y uso#

Las tarifas se publican en créditos de IA en EUR para el modelo, proveedor, unidades y variantes seleccionados. Solo se cobran las dimensiones en su tarifa activa. Una estimación reserva créditos antes de la ejecución; los cargos finales usan el uso medido. Los precios pueden depender de la resolución, el formato de salida o una banda de uso. Consulte Uso en la Consola para el débito final de ShareAI. Los campos de costos ascendentes y bytes de medios no se convierten en recuentos de tokens inventados.

Acceso y errores#

Usar inference para inferencia aprobada con costo de red o monetization_gateway para un margen aprobado del Builder y términos de facturación aceptados. El acceso solo con identidad no autoriza gastos. La validación, autorización del modelo, créditos insuficientes, límites de tarifa y fallos de ejecución devuelven una error. estructura. Después de un tiempo de espera o envío incierto, inspeccione Uso o el trabajo de video antes de crear otra solicitud potencialmente pagada.

Última actualización noviembre 3, 2026.

Documentación de la plataforma ShareAI
Toda la documentación

Buscar por título o contenido.

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI