Начинаем
Выбор API-эндпоинта
Базовый URL-адрес, выбор хоста и семейство API для отправки каждого запроса.
Modelflare использует один ключ API для нескольких протоколов. Конверт JSON не одинаков для каждой модели. Сначала выберите семейство, затем скопируйте запрос из руководства по подбору или страницы модели.
Базовый URL
Заголовок раздела «Базовый URL»https://modelflare.dev/v1Трафик EdgeOne, обращенный к Китаю, может использовать https://origin.modelflare.dev/v1 для того же приложения. Выберите хост перед отправкой запроса; не перенаправляйте текущий POST между хостами.
Anthropic являются исключением: ANTHROPIC_BASE_URL — это https://modelflare.dev (исходный сайт, а не /v1). Официальный интерфейс командной строки Claude Code добавляет сам путь к сообщениям. См. Claude Code.
Аутентификация
Заголовок раздела «Аутентификация»Authorization: Bearer YOUR_MODELFLARE_API_KEYОтправляйте этот заголовок при каждом запросе, включая видеоопрос и загрузку. Создайте ключ в консоли. Подробности: Аутентификация.
https://modelflare.devChat Completions
POST /v1/chat/completions Чат, совместимый с OpenAI.
Responses
POST /v1/responses Codex и Grok Build.
Anthropic Messages
ANTHROPIC_BASE_URL=https://modelflare.dev Интерфейс командной строки Claude Code добавляет сам путь к сообщениям.
Изображения
POST /v1/images/generations Изображения GPT, Wan Image и Seedream.
Gemini родной
POST /v1/models/{model}:generateContent Gemini. Gemini CLI использует написание /v1beta.
Видео
POST /v1/videos Создает задачу: опросить ее, затем загрузить результат.
Seedance активы
POST /volc/asset/* Управление группами ресурсов Seedance и идентификаторами медиа на стороне провайдера.
Модели
GET /v1/models Что может вызывать текущий ключ.
| Семья | Типичная запись | Используйте это для |
|---|---|---|
| Chat Completions | POST /v1/chat/completions |
Чат, совместимый с OpenAI. Первый запрос: Quickstart. |
| Responses | POST /v1/responses |
Codex и Grok Build. |
| Anthropic Messages | Сообщения, совместимые с Anthropic | Claude Code. |
| Изображения | POST /v1/images/generations |
Изображения GPT, Wan Image и Seedream. Точные поля: модели изображений. |
| Gemini родной | POST /v1/models/{model}:generateContent |
Gemini модели изображений; также служил на origin.modelflare.dev. Gemini CLI строит тот же путь под /v1beta, который обслуживает только modelflare.dev. |
| Видео | POST /v1/videos |
Seedance, Wan, Kling и другие модели асинхронного видео. Опросите GET /v1/videos/{task_id} и загрузите GET /v1/videos/{task_id}/content. Точный конверт: видеомодели. |
| Seedance активы | POST /volc/asset/* |
Создание, запрос, обновление и удаление групп активов и медиа на стороне поставщика. См. Seedance управление активами. |
| Модели | GET /v1/models |
Список моделей, которые может вызывать текущий ключ. |
Запросы изображения и видео с неправильной конечной точки отклоняются с помощью unsupported_endpoint. Не отправляйте поля изображения Gemini в /v1/images/* или поля изображений GPT в generateContent. Не смешивайте поля Chat Completions с клиентом Responses или Anthropic.
Изображение и видео работают с Smart API Key или групповым API-ключом media. Срок действия URL-адресов результатов может истечь; передать файл после успешного выполнения видеозадачи.
Вызовы управления активами Seedance принимают одни и те же ключи: смарт-ключ API или групповой ключ API media. Создание активов является асинхронным; используйте GetAsset до Active, затем передайте возвращенный asset://<ID> без изменений в поддерживаемом запросе Seedance. Шлюз сохраняет право собственности на активы за каждым пользователем и не взимает отдельную плату за управление ресурсами.
Список моделей для этого ключа
Заголовок раздела «Список моделей для этого ключа»https://modelflare.dev/v1/modelscurl https://modelflare.dev/v1/models \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"В ответе перечислены модели, которые может вызывать текущий ключ. Он не заменяет Модели и цены, который включает цены, группы и метки протоколов. Используйте точное значение id в поле JSON model. См. Модели и группы.