Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Criar uma mensagem do Claude

Felo API Support
MIT
Servidor:https://openapi.felo.ai
Bibliotecas Cliente
Shell Curl

Criar uma mensagem do Claude

​

Endpoint compatível com a API Messages do Claude. Defina stream=true para receber eventos de streaming de mensagens no estilo do Claude. Os campos de requisição, resposta e erro de validação seguem o protocolo Messages do Claude; o Router também pode retornar um envelope de erro de gateway saneado para falhas de infraestrutura.

Cabeçalhos
  • X-Felo-Channel
    Tipo: string

    Códigos de canal público separados por vírgula, em ordem. Omita este cabeçalho para usar default; default deve ser usado sozinho. No modo carteira, default percorre a ordem efetiva de canais públicos do modelo em ordem inversa, ignora canais não publicados ou indisponíveis e seleciona o provedor do primeiro canal disponível. Inclui os endpoints disponíveis desse provedor com o mesmo ID de modelo upstream e o mesmo service tier. Canais explícitos são validados na ordem especificada pelo cliente; somente o grupo de provedores do primeiro canal é enviado. Não há fallback automático para outros provedores. Cabeçalhos legados de provedor não podem substituir o roteamento por canal.

Corpo·ClaudeMessagesRequest
obrigatório
application/json
  • max_tokens
    Tipo: integer
    mín:  
    1
    obrigatório

    Integer numbers.

  • messages
    Tipo: array object[] · ClaudeMessage[] 1…
    obrigatório
    • content
      obrigatório
      • Tipo: string
    • role
      Tipo: string enum
      obrigatório
      valores
      • user
      • assistant
    • propertyName
      Tipo: anything
  • model
    Tipo: string
    obrigatório
  • metadata
    Tipo: object
    • propertyName
      Tipo: anything
  • service_tier
    Tipo: string | null

    Atualmente, apenas default (standard) é suportado. Valores omitidos, null, aliases e strings não suportadas usam default; outros tipos retornam HTTP 400. Os canais e preços configurados permanecem inalterados. As APIs de texto enviam o valor padrão do provedor; as APIs Decisions e de geração omitem o campo upstream.

  • stop_sequences
    Tipo: array string[]
  • stream
    Tipo: boolean
  • system
    • Tipo: string
  • temperature
    Tipo: number
    mín:  
    0
    máx:  
    1
  • thinking
    Tipo: object
    • propertyName
      Tipo: anything
  • tool_choice
    • Tipo: string
  • tools
    Tipo: array object[]
    • propertyName
      Tipo: anything
  • propertyName
    Tipo: anything
  • top_k
    Tipo: integer
    mín:  
    0

    Integer numbers.

  • top_p
    Tipo: number
    mín:  
    0
    máx:  
    1
  • propertyName
    Tipo: anything
Respostas
  • 200
    Tipo: object · ClaudeMessageResponse

    Mensagem do Claude ou resposta em streaming

    • content
      Tipo: array object[] · ClaudeContentBlock[]
      obrigatório
      • type
        Tipo: string enum
        obrigatório
        valores
        • text
        • image
        • document
        • tool_use
        • tool_result
        • thinking
      • content
        Tipo: string | array
      • id
        Tipo: string
      • input
        Tipo: object
        • propertyName
          Tipo: anything
      • name
        Tipo: string
      • source
        Tipo: object
        • propertyName
          Tipo: anything
      • text
        Tipo: string
      • propertyName
        Tipo: anything
    • id
      Tipo: string
      obrigatório
    • model
      Tipo: string
      obrigatório
    • role
      const:  
      assistant
      obrigatório
    • stop_reason
      Tipo: string | null
      obrigatório
    • type
      const:  
      message
      obrigatório
    • stop_sequence
      Tipo: string | null
    • usage
      Tipo: object · Usage

      Objeto de uso do provedor. Os campos variam conforme o endpoint e o provedor.

      • propertyName
        Tipo: anything
    • propertyName
      Tipo: anything
  • 400
    Tipo: object · ClaudeErrorResponse

    invalid_request_error do Claude ou erro de validação da requisição no Router

    Envelope de erro compatível com a API Errors do Claude para requisições Messages.

    • error
      Tipo: object
      obrigatório
      • message
        Tipo: string
        obrigatório
      • type
        Tipo: string
        obrigatório
      • propertyName
        Tipo: anything
    • type
      const:  
      error
      obrigatório
    • request_id
      Tipo: string
    • propertyName
      Tipo: anything
    application/json
  • 401
    Tipo: object · ClaudeErrorResponse

    Chave de API da Felo inválida ou ausente

    Envelope de erro compatível com a API Errors do Claude para requisições Messages.

    • error
      Tipo: object
      obrigatório
      • message
        Tipo: string
        obrigatório
      • type
        Tipo: string
        obrigatório
      • propertyName
        Tipo: anything
    • type
      const:  
      error
      obrigatório
    • request_id
      Tipo: string
    • propertyName
      Tipo: anything
    application/json
  • 402
    Tipo: object · ClaudeErrorResponse

    Saldo insuficiente

    Envelope de erro compatível com a API Errors do Claude para requisições Messages.

    • error
      Tipo: object
      obrigatório
      • message
        Tipo: string
        obrigatório
      • type
        Tipo: string
        obrigatório
      • propertyName
        Tipo: anything
    • type
      const:  
      error
      obrigatório
    • request_id
      Tipo: string
    • propertyName
      Tipo: anything
    application/json
  • 403
    Tipo: object · ClaudeErrorResponse

    A conta não tem permissão para usar o modelo. Modelos desativados também são rejeitados antes das chamadas upstream. Requisições e tarefas já aceitas continuam.

    Envelope de erro compatível com a API Errors do Claude para requisições Messages.

    • error
      Tipo: object
      obrigatório
      • message
        Tipo: string
        obrigatório
      • type
        Tipo: string
        obrigatório
      • propertyName
        Tipo: anything
    • type
      const:  
      error
      obrigatório
    • request_id
      Tipo: string
    • propertyName
      Tipo: anything
    application/json
  • 429
    Tipo: object · ClaudeErrorResponse

    Limite de gastos ou de requisições atingido

    Envelope de erro compatível com a API Errors do Claude para requisições Messages.

    • error
      Tipo: object
      obrigatório
      • message
        Tipo: string
        obrigatório
      • type
        Tipo: string
        obrigatório
      • propertyName
        Tipo: anything
    • type
      const:  
      error
      obrigatório
    • request_id
      Tipo: string
    • propertyName
      Tipo: anything
    application/json
  • 502
    Tipo: object · ClaudeErrorResponse

    Falha na requisição ao provedor upstream

    Envelope de erro compatível com a API Errors do Claude para requisições Messages.

    • error
      Tipo: object
      obrigatório
      • message
        Tipo: string
        obrigatório
      • type
        Tipo: string
        obrigatório
      • propertyName
        Tipo: anything
    • type
      const:  
      error
      obrigatório
    • request_id
      Tipo: string
    • propertyName
      Tipo: anything
    application/json
  • 503
    Tipo: object · ClaudeErrorResponse

    Provedor ou serviço de cobrança indisponível

    Envelope de erro compatível com a API Errors do Claude para requisições Messages.

    • error
      Tipo: object
      obrigatório
      • message
        Tipo: string
        obrigatório
      • type
        Tipo: string
        obrigatório
      • propertyName
        Tipo: anything
    • type
      const:  
      error
      obrigatório
    • request_id
      Tipo: string
    • propertyName
      Tipo: 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"
}

Mensagem do Claude ou resposta em streaming

Create a Claude message