ThAPI 연동 문서

빠른 시작

예제에 필요한 라이브러리와 지원 런타임을 준비하고 환경에 STALI_API_KEY를 설정하세요. 예제 모델을 프로토콜에 맞는 현재 사용 가능한 모델로 바꾸세요.

read -r -s -p "STALI_API_KEY: " STALI_API_KEY
export STALI_API_KEY
printf '\n'
curl -fsS https://thapi.cloud/v1/models -H "Authorization: Bearer ${STALI_API_KEY:?STALI_API_KEY}"

cURL 예제는 macOS/Linux의 Bash 또는 WSL/Git Bash용입니다. STALI_API_KEY가 없으면 Python이 키 입력을 요청하며 Node.js는 환경 변수에서 읽습니다.

curl -N https://thapi.cloud/v1/messages \
  -H "x-api-key: ${STALI_API_KEY:?STALI_API_KEY}" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [
      { "role": "user", "content": "Viết hàm quicksort bằng Python" }
    ]
  }'

콘텐츠 생성 예제는 실제 요청을 전송하므로 요금이 발생할 수 있습니다. 실행 전에 과금 단위와 요청당 최소 요금을 확인하세요.

API CLI 설치

Node.js 18 이상이 필요합니다. API CLI를 설치한 뒤 thapi를 실행하여 마법사에서 키를 입력하세요. api-cli doctor로 설정을 확인하세요. 채팅이나 ping 요청에도 요금이 부과될 수 있습니다.

# Windows, macOS, Linux 공통 권장 방법: Node.js >= 18 필요
npm install -g stali-cli@latest

# 대체 설치 도구: npm, 실패 시 GitHub + Bun 사용:
# curl -fsSL "https://thapi.cloud/install/stali-cli.sh" | bash

# 설치만 하고 설정 마법사를 열지 않기:
# curl -fsSL "https://thapi.cloud/install/stali-cli.sh" | STALI_CLI_NO_RUN=1 bash

stali

앱 연결

도구와 프로토콜별 안내를 찾습니다.

이미지 생성 및 편집

이미지 생성, 참조 이미지, 결과 처리와 요금을 위한 JSON 안내입니다.

비디오 생성

Videos API로 텍스트와 이미지에서 동영상을 만들고 진행 상황을 확인하여 MP4를 다운로드합니다.

이미지 읽기

형식과 작업 수명 주기를 확인합니다.

응답 헤더

x-thapi-request-id가 있으면 오류 발생 시간과 함께 보관하세요. 보고서에 API 키나 민감한 내용을 넣지 마세요.

문제 해결

Retry-After를 따르고 지터가 있는 지수 백오프를 사용하며 횟수와 총시간을 제한하세요. 비디오 작업이 생성되었을 수 있다면 재전송 전에 ID로 조회하세요.