채팅 완료 생성
OpenAI 호환 Chat Completions API입니다. stream=true로 설정하면 서버 전송 이벤트(SSE)를 받습니다. 응답 및 오류 봉투는 Chat Completions/OpenAI 호환 형식을 따릅니다.
- 유형: stringX
- Felo - Channel 공개 채널 코드를 쉼표로 구분한 순서 있는 목록입니다. 이 헤더를 생략하면 default를 사용하며, default는 단독으로만 사용해야 합니다. 지갑 모드에서 default는 모델의 유효 공개 채널 순서를 역순으로 스캔하고, 게시되지 않았거나 사용할 수 없는 채널을 건너뛰며, 사용 가능한 첫 번째 채널의 공급자를 선택합니다. 동일한 업스트림 모델 ID와 서비스 티어를 가진 해당 공급자의 사용 가능한 엔드포인트도 포함합니다. 명시적 채널은 클라이언트가 지정한 순서로 검증되며, 첫 번째 채널의 공급자 그룹만 제출됩니다. 다른 공급자로의 자동 fallback은 없습니다. 레거시 공급자 헤더로는 채널 라우팅을 재정의할 수 없습니다.
- 유형: array object[] · ChatMessage[] 1…messages필수
- contentnull 허용필수
- 유형: string
- role유형: string 열거형필수값
- system
- developer
- user
- assistant
- tool
- name유형: string
- tool유형: string
_call _id - tool유형: array object[]
_calls - property유형: anything
Name
- property유형: anything
Name
- 유형: stringmodel필수
- 유형: integermax
_completion _tokens 최솟값:1Integer numbers.
- 유형: integermax
_tokens 최솟값:1Integer numbers.
- 유형: integern최솟값:1
Integer numbers.
- 유형: objectresponse
_format - property유형: anything
Name
- 유형: string | nullservice
_tier 현재는 default(표준)만 지원합니다. 생략, null, 별칭 및 지원되지 않는 문자열은 default로 대체되며, 다른 유형은 HTTP 400을 반환합니다. 구성된 채널과 가격은 변경되지 않습니다. 텍스트 API는 공급자의 표준 값을 전송하고, Decisions 및 생성 API는 업스트림 필드를 생략합니다.
- null 허용stop
- 유형: string
- 유형: booleanstream
- 유형: numbertemperature최솟값:0
- tool
_choice - 유형: string
- 유형: array object[]tools
- property유형: anything
Name
- 유형: anythingproperty
Name
- 유형: numbertop
_p 최솟값:0최댓값:1 - 유형: stringuser
- 유형: anythingproperty
Name
- 유형: object · ChatCompletionResponse200
채팅 완료 또는 스트리밍 응답
- 유형: array object[] · ChatChoice[]choices필수
- finish유형: string | null
_reason - index유형: integer
Integer numbers.
- logprobs유형: object | null
- property유형: anything
Name
- message유형: object · ChatMessage
- contentnull 허용필수
- 유형: string
- role유형: string 열거형필수값
- system
- developer
- user
- assistant
- tool
- name유형: string
- tool유형: string
_call _id - tool유형: array object[]
_calls - property유형: anything
Name
- property유형: anything
Name
- property유형: anything
Name
- 유형: stringid필수
- 유형: stringobject필수
비스트리밍 응답의 경우 일반적으로 chat.completion입니다.
- 유형: integer 형식: int64created
Signed 64-bit integers (long type).
- 유형: stringmodel
- 유형: stringsystem
_fingerprint - 유형: object · Usageusage
공급자 사용량 객체입니다. 필드는 엔드포인트와 공급자에 따라 다릅니다.
- property유형: anything
Name
- 유형: anythingproperty
Name
- 유형: object · OpenAIErrorResponse400
잘못된 요청, 모델 또는 공급자 매핑
OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.
- 유형: objecterror필수
- message유형: string필수
- code유형: string | null
- param유형: string | null
- type유형: string
제공된 경우 OpenAI 호환 오류 유형입니다.
- property유형: anything
Name
- 유형: anythingproperty
Name
application/json - 유형: object · OpenAIErrorResponse401
Felo API 키가 유효하지 않거나 누락되었습니다
OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.
- 유형: objecterror필수
- message유형: string필수
- code유형: string | null
- param유형: string | null
- type유형: string
제공된 경우 OpenAI 호환 오류 유형입니다.
- property유형: anything
Name
- 유형: anythingproperty
Name
application/json - 유형: object · OpenAIErrorResponse402
잔액 부족
OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.
- 유형: objecterror필수
- message유형: string필수
- code유형: string | null
- param유형: string | null
- type유형: string
제공된 경우 OpenAI 호환 오류 유형입니다.
- property유형: anything
Name
- 유형: anythingproperty
Name
application/json - 유형: object · OpenAIErrorResponse403
계정에 이 모델을 사용할 권한이 없습니다. 비활성화된 모델은 업스트림 호출 전에 거부됩니다. 이미 접수된 요청과 작업은 계속 진행됩니다.
OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.
- 유형: objecterror필수
- message유형: string필수
- code유형: string | null
- param유형: string | null
- type유형: string
제공된 경우 OpenAI 호환 오류 유형입니다.
- property유형: anything
Name
- 유형: anythingproperty
Name
application/json - 유형: object · OpenAIErrorResponse429
지출 또는 요청 한도에 도달했습니다
OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.
- 유형: objecterror필수
- message유형: string필수
- code유형: string | null
- param유형: string | null
- type유형: string
제공된 경우 OpenAI 호환 오류 유형입니다.
- property유형: anything
Name
- 유형: anythingproperty
Name
application/json - 유형: object · OpenAIErrorResponse502
업스트림 공급자 요청 실패
OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.
- 유형: objecterror필수
- message유형: string필수
- code유형: string | null
- param유형: string | null
- type유형: string
제공된 경우 OpenAI 호환 오류 유형입니다.
- property유형: anything
Name
- 유형: anythingproperty
Name
application/json - 유형: object · OpenAIErrorResponse503
공급자 또는 청구 서비스를 사용할 수 없습니다
OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.
- 유형: objecterror필수
- message유형: string필수
- code유형: string | null
- param유형: string | null
- type유형: string
제공된 경우 OpenAI 호환 오류 유형입니다.
- property유형: anything
Name
- 유형: anythingproperty
Name
application/json
curl https://openapi.felo.ai/api/v1/chat/completions \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"model": "gpt-5.5",
"messages": [
{
"role": "user",
"content": "Write a one-sentence greeting."
}
],
"stream": false
}'
{
"id": "string",
"object": "string",
"created": 1,
"model": "string",
"choices": [
{
"index": 1,
"message": {
"role": "system",
"content": "string",
"name": "string",
"tool_call_id": "string",
"tool_calls": [
{
"additionalProperty": "anything"
}
],
"additionalProperty": "anything"
},
"finish_reason": null,
"logprobs": null,
"additionalProperty": "anything"
}
],
"usage": {
"additionalProperty": "anything"
},
"system_fingerprint": "string",
"additionalProperty": "anything"
}