Перейти к содержанию

POST responses — xAI

POST /xai/api/v1/responses создает ответ OpenAI Responses для текстовой модели хаба, напрямую или через конвертацию. Поля описаны в документации xAI Responses.

curl https://hub.coreinfra.ai/xai/api/v1/responses \
-H "Authorization: Bearer $COREINFRA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"grok-build-0.1","input":"2 + 2"}'

Ожидаемый текст — 4. Фрагмент ответа:

{"output":[{"type":"message","content":[{"type":"output_text","text":"4"}]}]}

Отличия от API xAI​

Поддерживаемые возможности​

Поле inference_geo и заголовок x-grok-model-override игнорируются; модель выбирается полем model в теле запроса. При вызове моделей xAI отключено сохранение (store: false) и игнорируются user, safety_identifier и service_tier. При вызове моделей OpenAI отключено сохранение (store: false), игнорируется safety_identifier, а из service_tier поддерживаются auto, default, priority, fast и ultrafast; у DeepSeek игнорируются user, safety_identifier и service_tier; у Moonshot AI игнорируются user, safety_identifier, service_tier и prompt_cache_options. Если выбранный service_tier не поддерживается тарифом модели, возвращается ошибка со статус-кодом 400.

Со статус-кодом 400 отклоняются:

  • background: true, значение prompt или conversation;
  • MCP-инструмент с tunnel_id;
  • инструменты code_interpreter, file_search, image_generation, x_search, code_execution, collections_search, attachment_search;
  • shell с окружением container_auto или container_reference.

Проверка инструментов применяется также внутри namespace и элементов additional_tools / tool_search_output во входе. Локальный shell и пользовательские функции не запрещаются этим правилом.

Изображения принимаются только в кодировке base64 (data:image/...;base64,...). Ссылки на внешние ресурсы, input_image.file_id, input_file.file_url и input_file.file_id отклоняются со статус-кодом 400, в том числе внутри результатов инструментов.

Когда в ответе модели Grok присутствуют данные о стоимости и сумма списания рассчитана, хаб возвращает стоимость запроса в рублях в поле usage.cost_rub.

При конвертации​

Действуют те же правила конвертации OpenAI Responses, что и на основном адресе OpenAI API: previous_response_id, conversation и item_reference отклоняются со статус-кодом 400, а специфичные параметры без эквивалента в протоколе модели не конвертируются.

Оплата​

Перед отправкой хаб резервирует средства по оценке запроса, после ответа рассчитывает стоимость по usage модели. При конвертации учитывается работа в протоколе модели. Правила расчета, кэша и завершения прерванных запросов — на странице «Стоимость генеративных моделей», цены — на «Тарифах». Вызовы веб-поиска и чтения страниц в ответе Responses учитываются отдельно от токенов.

Ошибки​

  • 400 — запрещенная возможность, вложение или ссылка на сохраненное состояние при конвертации.
  • 502 — ошибка на стороне провайдера модели при выполнении запроса. После начала SSE ошибка передается событием потока.

Формат ошибок приведен в разделе xAI API; общие ошибки ключа, выбора модели и баланса описаны в общем справочнике, ограничения — в разделе «Лимиты и ограничения».