Claude 메시지 생성
Claude Messages API 호환 엔드포인트입니다. stream=true로 설정하면 Claude 스타일 메시지 스트림 이벤트를 받습니다. 요청, 응답, 검증 오류 필드는 Claude Messages 프로토콜을 따르며, Router는 인프라 장애 시 정제된 게이트웨이 오류 봉투를 반환할 수도 있습니다.
- 유형: stringX
- Felo - Channel 공개 채널 코드를 쉼표로 구분한 순서 있는 목록입니다. 이 헤더를 생략하면 default를 사용하며, default는 단독으로만 사용해야 합니다. 지갑 모드에서 default는 모델의 유효 공개 채널 순서를 역순으로 스캔하고, 게시되지 않았거나 사용할 수 없는 채널을 건너뛰며, 사용 가능한 첫 번째 채널의 공급자를 선택합니다. 동일한 업스트림 모델 ID와 서비스 티어를 가진 해당 공급자의 사용 가능한 엔드포인트도 포함합니다. 명시적 채널은 클라이언트가 지정한 순서로 검증되며, 첫 번째 채널의 공급자 그룹만 제출됩니다. 다른 공급자로의 자동 fallback은 없습니다. 레거시 공급자 헤더로는 채널 라우팅을 재정의할 수 없습니다.
- 유형: 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 열거형필수값
- user
- assistant
- property유형: anything
Name
- 유형: stringmodel필수
- 유형: objectmetadata
- property유형: anything
Name
- 유형: string | nullservice
_tier 현재는 default(표준)만 지원합니다. 생략, null, 별칭 및 지원되지 않는 문자열은 default로 대체되며, 다른 유형은 HTTP 400을 반환합니다. 구성된 채널과 가격은 변경되지 않습니다. 텍스트 API는 공급자의 표준 값을 전송하고, Decisions 및 생성 API는 업스트림 필드를 생략합니다.
- 유형: 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 열거형필수값
- 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 요청 검증 오류
Messages 요청에 대한 Claude Errors API 호환 오류 봉투입니다.
- 유형: objecterror필수
- message유형: string필수
- type유형: string필수
- property유형: anything
Name
- type상수:error필수
- 유형: stringrequest
_id - 유형: anythingproperty
Name
application/json - 유형: object · ClaudeErrorResponse401
Felo API 키가 유효하지 않거나 누락되었습니다
Messages 요청에 대한 Claude Errors API 호환 오류 봉투입니다.
- 유형: objecterror필수
- message유형: string필수
- type유형: string필수
- property유형: anything
Name
- type상수:error필수
- 유형: stringrequest
_id - 유형: anythingproperty
Name
application/json - 유형: object · ClaudeErrorResponse402
잔액 부족
Messages 요청에 대한 Claude Errors API 호환 오류 봉투입니다.
- 유형: objecterror필수
- message유형: string필수
- type유형: string필수
- property유형: anything
Name
- type상수:error필수
- 유형: stringrequest
_id - 유형: anythingproperty
Name
application/json - 유형: object · ClaudeErrorResponse403
계정에 이 모델을 사용할 권한이 없습니다. 비활성화된 모델은 업스트림 호출 전에 거부됩니다. 이미 접수된 요청과 작업은 계속 진행됩니다.
Messages 요청에 대한 Claude Errors API 호환 오류 봉투입니다.
- 유형: objecterror필수
- message유형: string필수
- type유형: string필수
- property유형: anything
Name
- type상수:error필수
- 유형: stringrequest
_id - 유형: anythingproperty
Name
application/json - 유형: object · ClaudeErrorResponse429
지출 또는 요청 한도에 도달했습니다
Messages 요청에 대한 Claude Errors API 호환 오류 봉투입니다.
- 유형: objecterror필수
- message유형: string필수
- type유형: string필수
- property유형: anything
Name
- type상수:error필수
- 유형: stringrequest
_id - 유형: anythingproperty
Name
application/json - 유형: object · ClaudeErrorResponse502
업스트림 공급자 요청 실패
Messages 요청에 대한 Claude Errors API 호환 오류 봉투입니다.
- 유형: objecterror필수
- message유형: string필수
- type유형: string필수
- property유형: anything
Name
- type상수:error필수
- 유형: stringrequest
_id - 유형: anythingproperty
Name
application/json - 유형: object · ClaudeErrorResponse503
공급자 또는 청구 서비스를 사용할 수 없습니다
Messages 요청에 대한 Claude Errors API 호환 오류 봉투입니다.
- 유형: 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"
}