curl로 API 호출

curl로 API 호출

이 가이드를 읽고 나면 curl 명령어로 대화 호출을 완료할 수 있습니다. 본 사이트 API는 OpenAI 호환입니다. 전체 매개변수 설명은 OpenAI 공식 문서를 참조하세요.

요청

curl https://api.tvtapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-name",
    "messages": [
      {"role": "system", "content": "당신은 도움이 되는 조수입니다"},
      {"role": "user", "content": "안녕하세요"}
    ]
  }'

3곳을 교체:

  1. sk-xxxxxxxx → 본인의 API Key
  2. your-model-name → 모델 광장에서 복사한 모델명
  3. 안녕하세요 → 전송할 내용

응답

정상적으로 JSON이 반환되며, 모델의 응답은 choices[0].message.content에 있습니다.

자주 쓰는 매개변수

  • temperature: 무작위성. 0이 가장 안정적, 1이 가장 창의적
  • max_tokens: 응답 최대 길이 제한
  • stream: true로 설정 시 스트리밍 출력, 응답이 글자 단위로 반환

문제 해결

  • 401: Key 오류. 오류 코드 설명 참조.
  • 429: 요청이 너무 많음. 나중에 재시도하세요.
  • 오랫동안 응답 없음: 네트워크 확인. Base URL이 https://api.tvtapi.com/v1인지 확인.