Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

채팅 완료 생성

서버:https://openapi.felo.ai
클라이언트 라이브러리

채팅 완료 생성

​

OpenAI 호환 Chat Completions API입니다. stream=true로 설정하면 서버 전송 이벤트(SSE)를 받습니다. 응답 및 오류 봉투는 Chat Completions/OpenAI 호환 형식을 따릅니다.

헤더
  • X-Felo-Channel
    유형: string

    공개 채널 코드를 쉼표로 구분한 순서 있는 목록입니다. 이 헤더를 생략하면 default를 사용하며, default는 단독으로만 사용해야 합니다. 지갑 모드에서 default는 모델의 유효 공개 채널 순서를 역순으로 스캔하고, 게시되지 않았거나 사용할 수 없는 채널을 건너뛰며, 사용 가능한 첫 번째 채널의 공급자를 선택합니다. 동일한 업스트림 모델 ID와 서비스 티어를 가진 해당 공급자의 사용 가능한 엔드포인트도 포함합니다. 명시적 채널은 클라이언트가 지정한 순서로 검증되며, 첫 번째 채널의 공급자 그룹만 제출됩니다. 다른 공급자로의 자동 fallback은 없습니다. 레거시 공급자 헤더로는 채널 라우팅을 재정의할 수 없습니다.

본문·ChatCompletionRequest
필수
application/json
  • messages
    유형: array object[] · ChatMessage[] 1…
    필수
    • content
      null 허용
      필수
      • 유형: string
    • role
      유형: string 열거형
      필수
      값
      • system
      • developer
      • user
      • assistant
      • tool
    • name
      유형: string
    • tool_call_id
      유형: string
    • tool_calls
      유형: array object[]
      • propertyName
        유형: anything
    • propertyName
      유형: anything
  • model
    유형: string
    필수
  • max_completion_tokens
    유형: integer
    최솟값:  
    1

    Integer numbers.

  • max_tokens
    유형: integer
    최솟값:  
    1

    Integer numbers.

  • n
    유형: integer
    최솟값:  
    1

    Integer numbers.

  • response_format
    유형: object
    • propertyName
      유형: anything
  • service_tier
    유형: string | null

    현재는 default(표준)만 지원합니다. 생략, null, 별칭 및 지원되지 않는 문자열은 default로 대체되며, 다른 유형은 HTTP 400을 반환합니다. 구성된 채널과 가격은 변경되지 않습니다. 텍스트 API는 공급자의 표준 값을 전송하고, Decisions 및 생성 API는 업스트림 필드를 생략합니다.

  • stop
    null 허용
    • 유형: string
  • stream
    유형: boolean
  • temperature
    유형: number
    최솟값:  
    0
  • tool_choice
    • 유형: string
  • tools
    유형: array object[]
    • propertyName
      유형: anything
  • propertyName
    유형: anything
  • top_p
    유형: number
    최솟값:  
    0
    최댓값:  
    1
  • user
    유형: string
  • propertyName
    유형: anything
응답
  • 200
    유형: object · ChatCompletionResponse

    채팅 완료 또는 스트리밍 응답

    • choices
      유형: array object[] · ChatChoice[]
      필수
      • finish_reason
        유형: string | null
      • index
        유형: integer

        Integer numbers.

      • logprobs
        유형: object | null
        • propertyName
          유형: anything
      • message
        유형: object · ChatMessage
        • content
          null 허용
          필수
          • 유형: string
        • role
          유형: string 열거형
          필수
          값
          • system
          • developer
          • user
          • assistant
          • tool
        • name
          유형: string
        • tool_call_id
          유형: string
        • tool_calls
          유형: array object[]
          • propertyName
            유형: anything
        • propertyName
          유형: anything
      • propertyName
        유형: anything
    • id
      유형: string
      필수
    • object
      유형: string
      필수

      비스트리밍 응답의 경우 일반적으로 chat.completion입니다.

    • created
      유형: integer 형식: int64

      Signed 64-bit integers (long type).

    • model
      유형: string
    • system_fingerprint
      유형: string
    • usage
      유형: object · Usage

      공급자 사용량 객체입니다. 필드는 엔드포인트와 공급자에 따라 다릅니다.

      • propertyName
        유형: anything
    • propertyName
      유형: anything
  • 400
    유형: object · OpenAIErrorResponse

    잘못된 요청, 모델 또는 공급자 매핑

    OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.

    • error
      유형: object
      필수
      • message
        유형: string
        필수
      • code
        유형: string | null
      • param
        유형: string | null
      • type
        유형: string

        제공된 경우 OpenAI 호환 오류 유형입니다.

      • propertyName
        유형: anything
    • propertyName
      유형: anything
    application/json
  • 401
    유형: object · OpenAIErrorResponse

    Felo API 키가 유효하지 않거나 누락되었습니다

    OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.

    • error
      유형: object
      필수
      • message
        유형: string
        필수
      • code
        유형: string | null
      • param
        유형: string | null
      • type
        유형: string

        제공된 경우 OpenAI 호환 오류 유형입니다.

      • propertyName
        유형: anything
    • propertyName
      유형: anything
    application/json
  • 402
    유형: object · OpenAIErrorResponse

    잔액 부족

    OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.

    • error
      유형: object
      필수
      • message
        유형: string
        필수
      • code
        유형: string | null
      • param
        유형: string | null
      • type
        유형: string

        제공된 경우 OpenAI 호환 오류 유형입니다.

      • propertyName
        유형: anything
    • propertyName
      유형: anything
    application/json
  • 403
    유형: object · OpenAIErrorResponse

    계정에 이 모델을 사용할 권한이 없습니다. 비활성화된 모델은 업스트림 호출 전에 거부됩니다. 이미 접수된 요청과 작업은 계속 진행됩니다.

    OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.

    • error
      유형: object
      필수
      • message
        유형: string
        필수
      • code
        유형: string | null
      • param
        유형: string | null
      • type
        유형: string

        제공된 경우 OpenAI 호환 오류 유형입니다.

      • propertyName
        유형: anything
    • propertyName
      유형: anything
    application/json
  • 429
    유형: object · OpenAIErrorResponse

    지출 또는 요청 한도에 도달했습니다

    OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.

    • error
      유형: object
      필수
      • message
        유형: string
        필수
      • code
        유형: string | null
      • param
        유형: string | null
      • type
        유형: string

        제공된 경우 OpenAI 호환 오류 유형입니다.

      • propertyName
        유형: anything
    • propertyName
      유형: anything
    application/json
  • 502
    유형: object · OpenAIErrorResponse

    업스트림 공급자 요청 실패

    OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.

    • error
      유형: object
      필수
      • message
        유형: string
        필수
      • code
        유형: string | null
      • param
        유형: string | null
      • type
        유형: string

        제공된 경우 OpenAI 호환 오류 유형입니다.

      • propertyName
        유형: anything
    • propertyName
      유형: anything
    application/json
  • 503
    유형: object · OpenAIErrorResponse

    공급자 또는 청구 서비스를 사용할 수 없습니다

    OpenAI 호환 오류 봉투입니다. Router는 모든 선택적 업스트림 필드 없이 code와 message를 포함할 수 있습니다.

    • error
      유형: object
      필수
      • message
        유형: string
        필수
      • code
        유형: string | null
      • param
        유형: string | null
      • type
        유형: string

        제공된 경우 OpenAI 호환 오류 유형입니다.

      • propertyName
        유형: anything
    • propertyName
      유형: anything
    application/json
Request Example for post/api/v1/chat/completions
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"
}
Create a chat completion

도움이 필요하신가요?

  • API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
  • Discord에서 Felo 개발자와 대화해 보세요.
  • 변경 내역을 확인해 보세요.
  • 대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
  • LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.