Referencia API
Imágenes
Genera imágenes a partir de prompts de texto usando los principales modelos de generación de imágenes mediante el endpoint compatible con OpenAI.
Endpoint
http
POST https://api.tokspan.com/v1/images/generationsParámetros de la Solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| model | string | Sí | ID del modelo (ej., dall-e-3, dall-e-2) |
| prompt | string | Sí | Descripción en texto de la imagen deseada (máx. 4000 caracteres) |
| n | integer | No | Número de imágenes a generar. Predeterminado: 1 |
| size | string | No | Resolución de la imagen. Los tamaños admitidos dependen del modelo — dall-e-2: 256x256, 512x512, 1024x1024; dall-e-3: 1024x1024, 1792x1024, 1024x1792 |
| quality | string | No | "standard" o "hd" (en los modelos de imagen compatibles) |
| response_format | string | No | "url" (predeterminado) o "b64_json" |
| style | string | No | "vivid" (predeterminado) o "natural" (en los modelos de imagen compatibles) |
Ejemplo
python
from openai import OpenAI
client = OpenAI(
api_key="sk-your-key",
base_url="https://api.tokspan.com/v1",
)
response = client.images.generate(
model="MODEL_NAME",
prompt="A serene mountain lake at sunset, digital art style",
n=1,
size="1024x1024",
)
print(response.data[0].url)Edición de Imágenes
http
POST https://api.tokspan.com/v1/images/edits| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| model | string | Sí | ID del modelo (ej., dall-e-3, dall-e-2) |
| image | file | Sí | La imagen de entrada a editar, como carga de archivo multipart (PNG, JPEG, WebP). |
| prompt | string | Sí | Descripción de texto de la edición deseada (ej., "añade un barco rojo al lago"). |
| mask | file | No | Máscara de imagen opcional que indica el área a editar. Las áreas transparentes se conservan. |
| n | integer | No | Número de imágenes a generar. Predeterminado: 1 |
| size | string | No | Resolución de la imagen. Los tamaños admitidos dependen del modelo — dall-e-2: 256x256, 512x512, 1024x1024; dall-e-3: 1024x1024, 1792x1024, 1024x1792 |
| response_format | string | No | "url" (predeterminado) o "b64_json" |
python
from openai import OpenAI
client = OpenAI(
api_key="sk-your-key",
base_url="https://api.tokspan.com/v1",
)
response = client.images.edit(
model="MODEL_NAME",
image=open("input.png", "rb"),
prompt="Add a red boat to the lake",
)
print(response.data[0].url)Modelos Disponibles
Los modelos de generación de imágenes compatibles incluyen los principales modelos de OpenAI y otros proveedores. Consulta la página de Modelos para conocer la disponibilidad y precios actuales.