OpenAI

이 페이지에는 HTTP 엔드포인트 참고 사항과 직접 cURL, Python 및 Node.js 요청 예제만 포함되어 있습니다.

엔드포인트 요약

Endpoint	Summary
`POST /v1/chat/completions`	다중 턴 대화, 도구 호출 및 선택적 스트리밍을 위한 표준 채팅 완료 엔드포인트입니다.
`POST /v1/responses`	구조화된 출력, 다중 모드 입력 및 향후 기능 확장을 위한 최신 통합 응답 엔드포인트입니다.

`POST /v1/chat/completions`

다중 턴 대화, 도구 호출 및 선택적 스트리밍을 위한 표준 채팅 완료 엔드포인트입니다.

요청사항

권한 부여로 인증: Bearer ; 핵심 페이로드 필드는 모델과 메시지입니다.
메시지는 시스템, 사용자 및 보조자 기록을 순서대로 보존해야 합니다. SSE 출력에 대해 stream=true를 추가하십시오.
OpenAI 호환 게이트웨이의 경우 이는 일반적으로 시작하기에 가장 안전한 기본 텍스트 엔드포인트입니다.

응답 메모

동기 출력은 일반적으로 choice[0].message.content에서 읽습니다.
도구 호출이 활성화되면 tool_calls와 후속 도구 교환을 함께 처리합니다.
스트리밍 모드는 하나의 완전한 JSON 응답이 아닌 SSE 청크를 반환합니다.

Examples

cURL

chat.completions

curl --request POST \
  --url https://api.tokenops.ai/v1/chat/completions \
  --header 'Authorization: Bearer ${YOUR_API_KEY}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4.1-mini",
    "messages": [
      { "role": "system", "content": "You are a concise API assistant." },
      { "role": "user", "content": "Give me a contact form field definition." }
    ]
  }'

Python

requests

import requests

response = requests.post(
    'https://api.tokenops.ai/v1/chat/completions',
    headers={
        'Authorization': 'Bearer ${YOUR_API_KEY}',
        'Content-Type': 'application/json'
    },
    json={
        'model': 'gpt-4.1-mini',
        'messages': [
            {'role': 'system', 'content': 'You are a concise API assistant.'},
            {'role': 'user', 'content': 'Give me a contact form field definition.'}
        ]
    },
    timeout=60
)

print(response.json())

Node.js

fetch

const response = await fetch('https://api.tokenops.ai/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ${YOUR_API_KEY}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4.1-mini',
    messages: [
      { role: 'system', content: 'You are a concise API assistant.' },
      { role: 'user', content: 'Give me a contact form field definition.' }
    ]
  })
})

console.log(await response.json())

응답 예시(200)

response

{
  "id": "chatcmpl_123",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "{\"name\":\"email\",\"type\":\"string\"}"
      }
    }
  ]
}

`POST /v1/responses`

구조화된 출력, 다중 모드 입력 및 향후 기능 확장을 위한 최신 통합 응답 엔드포인트입니다.

요청사항

여전히 Bearer 인증을 사용하지만 기본 페이로드 형태는 메시지보다는 입력 및 지침에 중점을 둡니다.
텍스트 및 구조화된 출력에 대해 하나의 끝점 모양을 원하는 경우 레거시 chat.completions보다 이를 선호합니다.
최신 응답 형식과 다중 모드 기능은 일반적으로 여기에 먼저 표시됩니다.

응답 메모

소비자는 일반적으로Choices[0].message 대신output[] 또는output_text에서 읽습니다.
워크플로가 비동기식이거나 도구 기반이 되면 일반적으로 이 끝점은 더 풍부한 상태 필드를 노출합니다.
마이그레이션 작업에는 필드 매핑, 재시도 및 서버 측 로깅이 포함되어야 합니다.

Examples

cURL

responses

curl --request POST \
  --url https://api.tokenops.ai/v1/responses \
  --header 'Authorization: Bearer ${YOUR_API_KEY}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-4.1-mini",
    "input": "Return a JSON contact form field definition."
  }'

Python

requests

import requests

response = requests.post(
    'https://api.tokenops.ai/v1/responses',
    headers={
        'Authorization': 'Bearer ${YOUR_API_KEY}',
        'Content-Type': 'application/json'
    },
    json={
        'model': 'gpt-4.1-mini',
        'input': 'Return a JSON contact form field definition.'
    },
    timeout=60
)

print(response.json())

Node.js

fetch

const response = await fetch('https://api.tokenops.ai/v1/responses', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ${YOUR_API_KEY}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-4.1-mini',
    input: 'Return a JSON contact form field definition.'
  })
})

console.log(await response.json())

응답 예시(200)

response

{
  "id": "resp_123",
  "status": "completed",
  "output": [
    {
      "type": "output_text",
      "text": "{\"name\":\"email\",\"type\":\"string\"}"
    }
  ]
}

接口指南

API端点

使用示例

엔드포인트 요약

`POST /v1/chat/completions`

요청사항

응답 메모

Examples

cURL

Python

Node.js

응답 예시(200)

`POST /v1/responses`

요청사항

응답 메모

Examples

cURL

Python

Node.js

응답 예시(200)

​엔드포인트 요약

​POST /v1/chat/completions

​요청사항

​응답 메모

​Examples

​cURL

​Python

​Node.js

​응답 예시(200)

​POST /v1/responses

​요청사항

​응답 메모

​Examples

​cURL

​Python

​Node.js

​응답 예시(200)

엔드포인트 요약

`POST /v1/chat/completions`

요청사항

응답 메모

Examples

cURL

Python

Node.js

응답 예시(200)

`POST /v1/responses`

요청사항

응답 메모

Examples

cURL

Python

Node.js

응답 예시(200)