Создание сообщения Claude
Эндпоинт, совместимый с Claude Messages API. Установите stream=true, чтобы получать потоковые события сообщений в стиле Claude. Поля запроса, ответа и ошибок валидации соответствуют протоколу Claude Messages; при сбоях инфраструктуры Router также может возвращать очищенный конверт ошибок шлюза.
- Тип: stringX
- Felo - Channel Упорядоченные публичные коды каналов через запятую. Опустите этот заголовок, чтобы использовать значение по умолчанию; default должен использоваться только сам по себе. В режиме wallet значение по умолчанию просматривает эффективный публичный порядок каналов модели в обратном направлении, пропускает неопубликованные и недоступные каналы и выбирает провайдера первого доступного канала. Оно включает доступные эндпоинты этого провайдера с тем же upstream ID модели и уровнем обслуживания. Явные каналы проверяются в порядке, указанном клиентом; отправляется только группа провайдера первого канала. Автоматического переключения на других провайдеров нет. Устаревшие заголовки провайдеров не могут переопределить маршрутизацию по каналам.
- Тип: integermax
_tokens мин.:1обязательноInteger numbers.
- Тип: array object[] · ClaudeMessage[] 1…messagesобязательно
Use a document block for a PDF or an image block for a picture. Set source to {type: 'file', file_id: 'felo_file_...'} for an uploaded Felo attachment, {type: 'url', url: 'https://...'} for an HTTPS URL, or provide type, media_type and data for a base64 source. PDF and image URL support are enabled per model.
- contentобязательно
- Тип: string
- roleТип: string enumобязательнозначения
- user
- assistant
- propertyТип: anything
Name
- Тип: stringmodelобязательно
- Тип: objectmetadata
- propertyТип: anything
Name
- Тип: string | nullservice
_tier Сейчас поддерживается только default (стандартный). Если поле опущено, равно null, содержит псевдоним или неподдерживаемую строку, используется значение по умолчанию; другие типы возвращают HTTP 400. Настроенные каналы и цены не меняются. Текстовые API передают стандартное значение провайдера; Decisions и API генерации опускают поле upstream.
- Тип: array string[]stop
_sequences - Тип: booleanstream
- system
- Тип: string
- Тип: numbertemperatureмин.:0макс.:1
- Тип: objectthinking
- propertyТип: anything
Name
- tool
_choice - Тип: string
- Тип: array object[]tools
- propertyТип: anything
Name
- Тип: anythingproperty
Name
- Тип: integertop
_k мин.:0Integer numbers.
- Тип: numbertop
_p мин.:0макс.:1 - Тип: anythingproperty
Name
- Тип: object · ClaudeMessageResponse200
Сообщение Claude или потоковый ответ
- Тип: array object[] · ClaudeContentBlock[]contentобязательно
- typeТип: string enumобязательнозначения
- text
- image
- document
- tool
_use - tool
_result - thinking
- contentТип: string | array
- idТип: string
- inputТип: object
- propertyТип: anything
Name
- nameТип: string
- sourceТип: object
- propertyТип: anything
Name
- textТип: string
- propertyТип: anything
Name
- Тип: stringidобязательно
- Тип: stringmodelобязательно
- roleконстанта:assistantобязательно
- Тип: string | nullstop
_reason обязательно - typeконстанта:messageобязательно
- Тип: string | nullstop
_sequence - Тип: object · Usageusage
Объект использования провайдера. Поля зависят от эндпоинта и провайдера.
- propertyТип: anything
Name
- Тип: anythingproperty
Name
- Тип: object · ClaudeErrorResponse400
Claude invalid_request_error или ошибка валидации запроса в Router
Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.
- Тип: objecterrorобязательно
- messageТип: stringобязательно
- typeТип: stringобязательно
- propertyТип: anything
Name
- typeконстанта:errorобязательно
- Тип: stringrequest
_id - Тип: anythingproperty
Name
application/json - Тип: object · ClaudeErrorResponse401
Недействительный или отсутствующий API-ключ Felo
Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.
- Тип: objecterrorобязательно
- messageТип: stringобязательно
- typeТип: stringобязательно
- propertyТип: anything
Name
- typeконстанта:errorобязательно
- Тип: stringrequest
_id - Тип: anythingproperty
Name
application/json - Тип: object · ClaudeErrorResponse402
Недостаточно средств на балансе
Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.
- Тип: objecterrorобязательно
- messageТип: stringобязательно
- typeТип: stringобязательно
- propertyТип: anything
Name
- typeконстанта:errorобязательно
- Тип: stringrequest
_id - Тип: anythingproperty
Name
application/json - Тип: object · ClaudeErrorResponse403
Аккаунт не имеет права использовать модель. Отключённые модели также отклоняются до вызова upstream. Уже принятые запросы и задачи продолжают выполняться.
Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.
- Тип: objecterrorобязательно
- messageТип: stringобязательно
- typeТип: stringобязательно
- propertyТип: anything
Name
- typeконстанта:errorобязательно
- Тип: stringrequest
_id - Тип: anythingproperty
Name
application/json - Тип: object · ClaudeErrorResponse429
Достигнут лимит расходов или запросов
Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.
- Тип: objecterrorобязательно
- messageТип: stringобязательно
- typeТип: stringобязательно
- propertyТип: anything
Name
- typeконстанта:errorобязательно
- Тип: stringrequest
_id - Тип: anythingproperty
Name
application/json - Тип: object · ClaudeErrorResponse502
Сбой запроса к upstream-провайдеру
Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.
- Тип: objecterrorобязательно
- messageТип: stringобязательно
- typeТип: stringобязательно
- propertyТип: anything
Name
- typeконстанта:errorобязательно
- Тип: stringrequest
_id - Тип: anythingproperty
Name
application/json - Тип: object · ClaudeErrorResponse503
Провайдер или сервис биллинга недоступен
Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.
- Тип: objecterrorобязательно
- messageТип: stringобязательно
- typeТип: stringобязательно
- propertyТип: anything
Name
- typeконстанта:errorобязательно
- Тип: stringrequest
_id - Тип: anythingproperty
Name
application/json
curl https://openapi.felo.ai/api/v1/messages \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Write a one-sentence greeting."
}
],
"stream": false
}'
{
"id": "string",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "string",
"id": "string",
"name": "string",
"input": {
"additionalProperty": "anything"
},
"content": "string",
"source": {
"additionalProperty": "anything"
},
"additionalProperty": "anything"
}
],
"model": "string",
"stop_reason": null,
"stop_sequence": null,
"usage": {
"additionalProperty": "anything"
},
"additionalProperty": "anything"
}