Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Создание сообщения Claude

Сервер:https://openapi.felo.ai
Клиентские библиотеки

Создание сообщения Claude

​

Эндпоинт, совместимый с Claude Messages API. Установите stream=true, чтобы получать потоковые события сообщений в стиле Claude. Поля запроса, ответа и ошибок валидации соответствуют протоколу Claude Messages; при сбоях инфраструктуры Router также может возвращать очищенный конверт ошибок шлюза.

Заголовки
  • X-Felo-Channel
    Тип: string

    Упорядоченные публичные коды каналов через запятую. Опустите этот заголовок, чтобы использовать значение по умолчанию; default должен использоваться только сам по себе. В режиме wallet значение по умолчанию просматривает эффективный публичный порядок каналов модели в обратном направлении, пропускает неопубликованные и недоступные каналы и выбирает провайдера первого доступного канала. Оно включает доступные эндпоинты этого провайдера с тем же upstream ID модели и уровнем обслуживания. Явные каналы проверяются в порядке, указанном клиентом; отправляется только группа провайдера первого канала. Автоматического переключения на других провайдеров нет. Устаревшие заголовки провайдеров не могут переопределить маршрутизацию по каналам.

Тело·ClaudeMessagesRequest
обязательно
application/json
  • max_tokens
    Тип: integer
    мин.:  
    1
    обязательно

    Integer numbers.

  • messages
    Тип: array object[] · ClaudeMessage[] 1…
    обязательно

    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
    • propertyName
      Тип: anything
  • model
    Тип: string
    обязательно
  • metadata
    Тип: object
    • propertyName
      Тип: anything
  • service_tier
    Тип: string | null

    Сейчас поддерживается только default (стандартный). Если поле опущено, равно null, содержит псевдоним или неподдерживаемую строку, используется значение по умолчанию; другие типы возвращают HTTP 400. Настроенные каналы и цены не меняются. Текстовые API передают стандартное значение провайдера; Decisions и API генерации опускают поле upstream.

  • stop_sequences
    Тип: array string[]
  • stream
    Тип: boolean
  • system
    • Тип: string
  • temperature
    Тип: number
    мин.:  
    0
    макс.:  
    1
  • thinking
    Тип: object
    • propertyName
      Тип: anything
  • tool_choice
    • Тип: string
  • tools
    Тип: array object[]
    • propertyName
      Тип: anything
  • propertyName
    Тип: anything
  • top_k
    Тип: integer
    мин.:  
    0

    Integer numbers.

  • top_p
    Тип: number
    мин.:  
    0
    макс.:  
    1
  • propertyName
    Тип: anything
Ответы
  • 200
    Тип: object · ClaudeMessageResponse

    Сообщение Claude или потоковый ответ

    • content
      Тип: array object[] · ClaudeContentBlock[]
      обязательно
      • type
        Тип: string enum
        обязательно
        значения
        • text
        • image
        • document
        • tool_use
        • tool_result
        • thinking
      • content
        Тип: string | array
      • id
        Тип: string
      • input
        Тип: object
        • propertyName
          Тип: anything
      • name
        Тип: string
      • source
        Тип: object
        • propertyName
          Тип: anything
      • text
        Тип: string
      • propertyName
        Тип: anything
    • id
      Тип: string
      обязательно
    • model
      Тип: string
      обязательно
    • role
      константа:  
      assistant
      обязательно
    • stop_reason
      Тип: string | null
      обязательно
    • type
      константа:  
      message
      обязательно
    • stop_sequence
      Тип: string | null
    • usage
      Тип: object · Usage

      Объект использования провайдера. Поля зависят от эндпоинта и провайдера.

      • propertyName
        Тип: anything
    • propertyName
      Тип: anything
  • 400
    Тип: object · ClaudeErrorResponse

    Claude invalid_request_error или ошибка валидации запроса в Router

    Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.

    • error
      Тип: object
      обязательно
      • message
        Тип: string
        обязательно
      • type
        Тип: string
        обязательно
      • propertyName
        Тип: anything
    • type
      константа:  
      error
      обязательно
    • request_id
      Тип: string
    • propertyName
      Тип: anything
    application/json
  • 401
    Тип: object · ClaudeErrorResponse

    Недействительный или отсутствующий API-ключ Felo

    Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.

    • error
      Тип: object
      обязательно
      • message
        Тип: string
        обязательно
      • type
        Тип: string
        обязательно
      • propertyName
        Тип: anything
    • type
      константа:  
      error
      обязательно
    • request_id
      Тип: string
    • propertyName
      Тип: anything
    application/json
  • 402
    Тип: object · ClaudeErrorResponse

    Недостаточно средств на балансе

    Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.

    • error
      Тип: object
      обязательно
      • message
        Тип: string
        обязательно
      • type
        Тип: string
        обязательно
      • propertyName
        Тип: anything
    • type
      константа:  
      error
      обязательно
    • request_id
      Тип: string
    • propertyName
      Тип: anything
    application/json
  • 403
    Тип: object · ClaudeErrorResponse

    Аккаунт не имеет права использовать модель. Отключённые модели также отклоняются до вызова upstream. Уже принятые запросы и задачи продолжают выполняться.

    Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.

    • error
      Тип: object
      обязательно
      • message
        Тип: string
        обязательно
      • type
        Тип: string
        обязательно
      • propertyName
        Тип: anything
    • type
      константа:  
      error
      обязательно
    • request_id
      Тип: string
    • propertyName
      Тип: anything
    application/json
  • 429
    Тип: object · ClaudeErrorResponse

    Достигнут лимит расходов или запросов

    Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.

    • error
      Тип: object
      обязательно
      • message
        Тип: string
        обязательно
      • type
        Тип: string
        обязательно
      • propertyName
        Тип: anything
    • type
      константа:  
      error
      обязательно
    • request_id
      Тип: string
    • propertyName
      Тип: anything
    application/json
  • 502
    Тип: object · ClaudeErrorResponse

    Сбой запроса к upstream-провайдеру

    Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.

    • error
      Тип: object
      обязательно
      • message
        Тип: string
        обязательно
      • type
        Тип: string
        обязательно
      • propertyName
        Тип: anything
    • type
      константа:  
      error
      обязательно
    • request_id
      Тип: string
    • propertyName
      Тип: anything
    application/json
  • 503
    Тип: object · ClaudeErrorResponse

    Провайдер или сервис биллинга недоступен

    Конверт ошибок, совместимый с Claude Errors API, для запросов Messages.

    • error
      Тип: object
      обязательно
      • message
        Тип: string
        обязательно
      • type
        Тип: string
        обязательно
      • propertyName
        Тип: anything
    • type
      константа:  
      error
      обязательно
    • request_id
      Тип: string
    • propertyName
      Тип: anything
    application/json
Request Example for post/api/v1/messages
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"
}
Create a Claude message

Нужна помощь?