Nội dungĐọc hình ảnh
Назад к документации

Изображения, аудио и видео

Проверьте форматы и жизненный цикл задач.

Перед отправкой изображений, аудио и видео проверьте возможности модели. Для асинхронного видео сохраняйте ID задачи и проверяйте статус; не создавайте задачу автоматически заново после обрыва ответа.

Чтение изображений

Модели с маркировкой Vision получают изображения в формате PNG/JPEG/WebP/GIF. Группе Claude через Anthropic Messages отправьте изображение base64 в том же поле содержимого, что и вопрос:

curl https://apivn.dev/v1/messages \
  -H "x-api-key: ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 512,
    "messages": [{
      "role": "user",
      "content": [
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/png",
            "data": "iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAIAAAAlC+aJAAAAXElEQVR4nO3PIREAIBAAsI+DQaPJhKbVF0JTggiIt7tbgcUds6LlKur7VISAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAwM8D31WVS4B9/IAAAAAASUVORK5CYII="
          }
        },
        {"type": "text", "text": "Опишите содержание этой фотографии"}
      ]
    }]
  }'

Модель GPT 16 использует стандарт image_url OpenAI непосредственно в /v1/chat/completions. Транзитный шлюз поддерживает как URL-адреса данных в формате Base64, так и URL-адреса изображений http:

{
  "model": "gpt-5.6-sol",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Прочтите этот фотоконтент"},
      {
        "type": "image_url",
        "image_url": {"url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAIAAAAlC+aJAAAAXElEQVR4nO3PIREAIBAAsI+DQaPJhKbVF0JTggiIt7tbgcUds6LlKur7VISAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAwM8D31WVS4B9/IAAAAAASUVORK5CYII="}
      }
    ]
  }]
}

Токены изображений, возвращаемые поставщиком, будут записываться и оплачиваться как входные токены. Рекомендуется сжимать изображения перед отправкой и сохранять все содержимое запроса в пределах 20 МБ.

Изображения, аудио и видео

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

JSON-интерфейсы для создания изображений, исходных данных, результатов и стоимости.

Открыть полное руководство

/v1/images/generations

curl https://apivn.dev/v1/images/generations \
  -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "model": "req/gpt-image-2",
    "prompt": "a tiny red circle on white",
    "size": "1024x1024",
    "n": 1
  }'

/v1/images/edits

curl https://apivn.dev/v1/images/edits \
  -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "model": "req/gpt-image-2",
    "prompt": "keep the same subject, soft studio lighting",
    "image": "https://example.com/reference.png",
    "size": "1024x1024",
    "n": 1
  }'

# image / image_url / reference_image / ref_image:
# data URL, base64 thuần, hoặc URL http(s) công khai
Создание видео

Примеры проходят проверку исходного кода и локальные проверки; это не подтверждает работу во всех версиях приложений. До эксплуатации проверьте настройки, небольшой запрос и usage.

Support