Управление маршрутизацией отдельного запроса
Настройте предел относительно официальной цены, число повторов и общий срок генерации текста через необязательные заголовки HTTP.
Управление маршрутизацией отдельного запроса
Включение и исключение каналов
Задайте набор каналов для запроса на генерацию текста, изображения или видео. Заголовки можно использовать вместе. Исключения имеют приоритет.
X-APIMaster-Include-Channels· Разрешить только перечисленные каналы.X-APIMaster-Exclude-Channels· Исключить перечисленные каналы.
Каждый заголовок принимает до 64 положительных целых чисел через запятую. Посмотрите публичные значения channel_id для модели. Доступные каналы определяются API-ключом и настройками консоли. Канал также должен поддерживать операцию и параметры запроса.
curl "https://apimaster.ai/api/public/marketplace?model=deepseek-flash"
Повторы и резервные попытки соблюдают этот набор. Асинхронная генерация сохраняет его. Эндпоинты с идемпотентной отправкой учитывают его при проверке.
Неверные заголовки возвращают 400 invalid_routing_parameter. Если подходящего канала нет, API возвращает 503 no_provider_within_channel_scope. Опрос и скачивание используют канал исходной задачи.
Опускайте заголовки при проверке или скачивании результата. Неподдерживаемые эндпоинты и управляемый пул FreeModel возвращают 400 routing_controls_unsupported.
Примеры генерации
curl "https://apimaster.ai/v1/chat/completions" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Exclude-Channels: $TEXT_CHANNEL_ID" \
-d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with OK."}]}'
curl "https://apimaster.ai/v1/images/generations/async" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Include-Channels: $IMAGE_CHANNEL_ID" \
-d '{"model":"gpt-image-2","prompt":"A blue ceramic cup on a white table","size":"1024x1024"}'
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Include-Channels: $VIDEO_CHANNEL_ID" \
-d '{"model":"wan3.0-video-prime","prompt":"A flower sways in a light breeze","duration":2,"resolution":"480P"}'
Цена, повторы и сроки для текста
Настройте предел относительно официальной цены, число повторов и общий срок генерации текста через необязательные заголовки HTTP.
| Заголовок | Поведение |
|---|---|
X-APIMaster-Max-Official-Price-Ratio |
Максимальная доля официальной цены, положительное число. 0.5 допускает половину официальной цены, 1 — полную официальную цену. |
X-APIMaster-Max-Retries |
Максимум дополнительных попыток после первой, целое неотрицательное число. 0 разрешает одну попытку. Переключение поставщика и переход к официальному поставщику учитываются. |
X-APIMaster-Timeout-Ms |
Общий срок в миллисекундах, положительное целое число. Отсчёт начинается при получении запроса шлюзом и включает маршрутизацию, повторы и потоковую передачу. Действует более короткий лимит. |
Каждый заголовок применяется независимо. Для пропущенных параметров действует текущая политика, а настройки поставщиков в консоли сохраняют силу. Предел применяется к тарифам на ввод, вывод и применимый кеш. Итоговая стоимость зависит от объёма использования. После начала передачи сгенерированных данных шлюз не запускает генерацию заново у другого поставщика.
Поддерживаемые конечные точки
POST /v1/chat/completionsPOST /v1/responsesPOST /v1/messagesPOST /v1beta/models/{model}:generateContentPOST /v1beta/models/{model}:streamGenerateContent
Эти параметры применяются к генерации текста. Методы для изображений, видео и другие неподдерживаемые методы возвращают 400 routing_controls_unsupported при наличии таких заголовков. Отдельно оплачиваемые операции, например вызовы инструментов, не входят в текстовый предел.
Пример
curl https://apimaster.ai/v1/chat/completions \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Max-Official-Price-Ratio: 0.5" \
-H "X-APIMaster-Max-Retries: 1" \
-H "X-APIMaster-Timeout-Ms: 30000" \
-d '{"model":"gpt-6.2-sol","messages":[{"role":"user","content":"Reply with OK."}]}'
Ошибки
Неверные значения дают 400 invalid_routing_parameter. Если официальную цену нельзя подтвердить, возвращается 400 official_price_unavailable. Если подходящего поставщика нет, до отправки возвращается 503 no_provider_within_price_limit. При истечении срока шлюз возвращает 504 request_deadline_exceeded до начала ответа или завершает текущий поток.
