Справочник API

Изображения

Создавайте изображения из текстовых промптов с помощью ведущих моделей генерации изображений через совместимый с OpenAI эндпоинт.

Конечная точка

http
POST https://api.tokspan.com/v1/images/generations

Параметры запроса

ПараметрТипОбязательныйОписание
modelstringДаID модели (например, dall-e-3, dall-e-2)
promptstringДаТекстовое описание желаемого изображения (максимум 4000 символов)
nintegerНетКоличество генерируемых изображений. По умолчанию: 1
sizestringНетРазрешение изображения. Поддерживаемые размеры зависят от модели — dall-e-2: 256x256, 512x512, 1024x1024; dall-e-3: 1024x1024, 1792x1024, 1024x1792
qualitystringНет"standard" или "hd" (на поддерживаемых моделях изображений)
response_formatstringНет"url" (по умолчанию) или "b64_json"
stylestringНет"vivid" (по умолчанию) или "natural" (на поддерживаемых моделях изображений)

Пример

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)

Редактирование изображений

http
POST https://api.tokspan.com/v1/images/edits
ПараметрТипОбязательныйОписание
modelstringДаID модели (например, dall-e-3, dall-e-2)
imagefileДаВходное изображение для редактирования, загружаемое как multipart-файл (PNG, JPEG, WebP).
promptstringДаТекстовое описание желаемого изменения (например, "добавьте красную лодку на озеро").
maskfileНетНеобязательное изображение маски, указывающее область для редактирования. Прозрачные области сохраняются.
nintegerНетКоличество генерируемых изображений. По умолчанию: 1
sizestringНетРазрешение изображения. Поддерживаемые размеры зависят от модели — dall-e-2: 256x256, 512x512, 1024x1024; dall-e-3: 1024x1024, 1792x1024, 1024x1792
response_formatstringНет"url" (по умолчанию) или "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)

Доступные модели

Поддерживаемые модели генерации изображений включают ведущие модели от OpenAI и других провайдеров. См. страницу Моделей для актуальной доступности моделей и цен.