콘텐츠로 이동

OpenAI API 응답 레퍼런스

이 문서는 Continuum Router의 확장 응답과 비교하기 위한 OpenAI API의 레퍼런스 응답을 포함합니다.

GET /v1/models

OpenAI /v1/models 엔드포인트는 최소한의 메타데이터와 함께 사용 가능한 모델 목록을 반환합니다.

응답 형식

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715367049,
      "owned_by": "system"
    },
    {
      "id": "gpt-4o-mini",
      "object": "model",
      "created": 1721172741,
      "owned_by": "system"
    },
    {
      "id": "gpt-4-turbo",
      "object": "model",
      "created": 1712361441,
      "owned_by": "system"
    },
    {
      "id": "gpt-4-0613",
      "object": "model",
      "created": 1686588896,
      "owned_by": "openai"
    },
    {
      "id": "gpt-3.5-turbo",
      "object": "model",
      "created": 1677610602,
      "owned_by": "openai"
    },
    {
      "id": "dall-e-3",
      "object": "model",
      "created": 1698785189,
      "owned_by": "system"
    },
    {
      "id": "dall-e-2",
      "object": "model",
      "created": 1698798177,
      "owned_by": "system"
    },
    {
      "id": "whisper-1",
      "object": "model",
      "created": 1677532384,
      "owned_by": "openai-internal"
    },
    {
      "id": "tts-1",
      "object": "model",
      "created": 1681940951,
      "owned_by": "openai-internal"
    },
    {
      "id": "tts-1-hd",
      "object": "model",
      "created": 1699053533,
      "owned_by": "system"
    },
    {
      "id": "text-embedding-ada-002",
      "object": "model",
      "created": 1671217299,
      "owned_by": "openai-internal"
    },
    {
      "id": "text-embedding-3-small",
      "object": "model",
      "created": 1705948997,
      "owned_by": "system"
    },
    {
      "id": "text-embedding-3-large",
      "object": "model",
      "created": 1705953180,
      "owned_by": "system"
    }
  ]
}

필드 설명

필드 타입 설명
id string 모델 식별자 (예: "gpt-4o", "dall-e-3")
object string 항상 "model"
created integer 모델이 생성된 Unix 타임스탬프
owned_by string 모델을 소유한 조직 ("openai", "system", "openai-internal")

주요 관찰 사항

  1. 기능 정보 없음: OpenAI API는 /v1/models 응답에 기능 정보를 포함하지 않습니다. 클라이언트는 다음에 의존해야 합니다:
  2. 모델 명명 규칙 (예: 이미지 생성의 경우 "dall-e")
  3. 외부 문서

  4. 시행착오

  5. 최소한의 메타데이터: 기본 식별 및 타임스탬프 필드만 제공됩니다.

  6. 컨텍스트 윈도우 정보 없음: 최대 토큰 제한이 응답에 포함되지 않습니다.

  7. 가격 정보 없음: 토큰당 비용은 이 엔드포인트를 통해 제공되지 않습니다.

Continuum Router 확장

Continuum Router는 model-metadata.yaml에서 추가 메타데이터로 표준 OpenAI 응답을 확장합니다:

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715367049,
      "owned_by": "system",
      "metadata": {
        "display_name": "GPT-4o",
        "developer": "OpenAI",
        "summary": "Most advanced multimodal model with vision capabilities",
        "capabilities": ["chat", "vision", "function_calling", "code"],
        "limits": {
          "context_window": 128000,
          "max_output": 16384
        }
      }
    },
    {
      "id": "dall-e-3",
      "object": "model",
      "created": 1698785189,
      "owned_by": "system",
      "metadata": {
        "display_name": "DALL-E 3",
        "developer": "OpenAI",
        "summary": "High quality image generation with detailed prompt understanding",
        "capabilities": ["image_generation"],
        "limits": {
          "context_window": 0,
          "max_output": 0,
          "max_prompt_length": 4000
        }
      }
    }
  ]
}

확장 필드

필드 타입 설명
metadata.display_name string 사람이 읽을 수 있는 모델 이름
metadata.developer string 모델을 개발한 회사/조직
metadata.summary string 모델 목적에 대한 간략한 설명
metadata.capabilities array 모델 기능 목록 (아래 참조)
metadata.limits.context_window integer 토큰 단위의 최대 컨텍스트 윈도우
metadata.limits.max_output integer 최대 출력 토큰

기능 값

표준화된 기능 값의 전체 목록은 model-metadata.yaml을 참조하세요:

  • 텍스트/채팅: chat, reasoning, code, function_calling, tool
  • 멀티모달 입력: vision, audio, video
  • 생성: image_generation, image_edit, image_variation
  • 기타: embedding, moderation

GET /v1/models/{model}

특정 모델에 대한 정보를 조회합니다.

요청

GET /v1/models/gpt-4o
Authorization: Bearer $OPENAI_API_KEY

응답

{
  "id": "gpt-4o",
  "object": "model",
  "created": 1715367049,
  "owned_by": "system"
}

개별 모델 조회에도 동일한 최소 필드가 반환됩니다.

참조 자료