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; общие ошибки ключа, выбора модели и баланса описаны в общем справочнике, ограничения — в разделе «Лимиты и ограничения».
