Generar imágenes
La respuesta JSON sincrónica contiene resultados de imágenes en los datos.
En esta página
https://api.shareai.now/api/v1/imagesGenerar imágenes
- URL base
https://api.shareai.now- Autenticación
- Clave API Bearer o token de acceso OAuth aprobado
- Alcance requerido
inferenceormonetization_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
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_IMAGES_MODEL',
'prompt': 'A quiet forest painted in watercolor.',
'n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/images', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/images", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Campos de solicitud#
| Campo | Tipo | Significado y límites |
|---|---|---|
model requerido | cadena | Identificador exacto de modelo público habilitado. Debe declarar esta operación y estar permitido por sus credenciales. |
prompt requerido | cadena | Indicador de generación no vacío, de un máximo de 256 KiB de texto UTF-8. |
n | entero | Cantidad opcional de imágenes, 1–10; por defecto 1. Su modelo puede permitir menos. |
size | cadena | Tamañ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. |
resolution | cadena | Selector de resolución compatible con el modelo, de un máximo de 100 caracteres; debe coincidir con la variante de tarifa publicada. |
aspect_ratio | cadena | Selector de relación de aspecto compatible con el modelo, de un máximo de 100 caracteres. |
quality | cadena | Selector de calidad compatible con el modelo, de un máximo de 100 caracteres; puede seleccionar una tasa diferente. |
response_format | cadena | Formato 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_format | cadena | Selector de codificación de salida compatible con el modelo, de un máximo de 100 caracteres. |
background | cadena | Configuración opcional de fondo de imagen cuando sea compatible con el modelo. |
seed | entero | Semilla opcional compatible con el modelo. El video requiere un número entero no negativo; la reproducibilidad depende del ejecutor. |
input_references | matriz | Un 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. |
provider | objeto | Preferencias 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.