Skip to main content
새 계정에는 체험 크레딧 $0.05가 제공되므로, 충전하지 않고도 아래의 첫 호출을 할 수 있습니다. gpt-5.4-mini와 같은 경량 모델이면 통합이 제대로 작동하는지 확인하기에 충분합니다.

두 가지 경로, 하나를 선택하십시오

AI에게 맡기기

하나의 prompt를 Codex, Claude Code 또는 Cursor에 복사합니다. 문서를 읽고, 코드를 작성하고, 실행합니다. 이미 코딩 에이전트와 함께 작업하고 있다면 가장 적합합니다.

직접 해보기

등록하고, key를 만들고, 첫 API 호출을 수행합니다. 세 단계, 5분입니다. 각 부분을 이해하고 싶다면 가장 적합합니다.
두 경로는 모두 같은 방식으로 시작합니다: 계정을 등록하고 key를 직접 생성합니다. AI가 대신할 수 있는 것은 그 이후의 모든 것입니다 — 모델을 선택하고, base URL을 올바르게 설정하고, 예제를 작성하고, 디버깅하는 일입니다.

AI가 직접 하게 하십시오

에이전트에 이 프롬프트를 보내십시오

코딩 에이전트가 APIYI를 스스로 통합하게 하십시오. Codex, Claude Code, Cursor 및 유사한 도구에 복사하여 붙여넣으십시오.

수행 내용

1

스킬을 설치하거나 skill.md를 직접 읽으십시오

https://docs.apiyi.com/skill.md는 기계용으로 작성된 통합 참고 자료입니다: 엔드포인트, 인증, 모델 명명 규칙, 알려진 함정 및 검증 체크리스트가 포함됩니다. 이를 읽으면 에이전트가 APIYI를 통합하는 데 필요한 모든 것을 얻습니다.
2

필요한 페이지를 찾아보십시오

llms.txt는 이 사이트의 모든 페이지 색인입니다. 에이전트는 관련된 페이지를 선택하고 .md를 덧붙여 일반 텍스트로 읽습니다.
3

코드를 작성하고 실제로 실행하십시오

문서의 Python을 그대로 복사하지 않고, 프로젝트의 기존 언어와 종속성에 맞춰 예제를 작성합니다. 호출이 성공해야 비로소 완료됩니다.

AI에 전달할 수 있는 네 가지 진입점

예를 들어, 이 페이지의 일반 텍스트 버전은 https://docs.apiyi.com/en/getting-started.md입니다. 이 사이트의 모든 페이지는 이 접미사를 지원합니다.

어떤 페이지든 바로 AI에 보내기

모든 문서 페이지의 오른쪽 상단에는 페이지 복사 버튼이 있습니다. 그 옆의 화살표를 열면 더 많은 옵션이 표시됩니다: 특정 모델에서 문제가 생기면 가장 빠른 방법은 해당 모델의 페이지를 열고 페이지 복사를 눌러 오류와 함께 AI에 보내는 것입니다.

직접 해보십시오

1단계: 가입하고 키를 받기

1

계정을 만드십시오

APIYI 웹사이트로 이동하여 이메일로 가입하고 인증한 뒤(대학교 또는 회사 이메일 주소를 권장합니다), 콘솔에 로그인합니다.
2

API 키를 만드십시오

token 페이지를 엽니다.
  1. 기본 token을 복사하여 바로 사용할 수 있습니다(오른쪽의 복사 아이콘)
  2. 또는 오른쪽 상단의 새로 만들기를 클릭하여 새로 만들고, 이름을 지정한 뒤(예: test-key), 확인합니다
키는 sk-로 시작합니다. 자세한 내용은 키를 만드는 방법을 참조하십시오.
3

잔액이 더 필요할 때 충전하기

$0.05 체험 크레딧이 소진되면 콘솔에서 충전하십시오. 최소 금액과 정산 규칙은 결제 채널에 따라 다릅니다. 자세한 내용은 결제 방법을 참조하시고, 보너스 정책은 충전 프로모션에서 확인하십시오.

2단계: 연결 정보를 올바르게 설정하기

SDK에 따라 base URL을 선택하고, 모델에 따라 선택하지 마십시오. 이것이 가장 흔한 통합 실수입니다:
base_url 끝에 슬래시를 두지 마십시오 — 그러면 슬래시가 중복되어 404가 발생합니다. 자세한 내용과 노드 선택은 base URL 설정에서 확인하실 수 있습니다.

3단계: 첫 호출을 수행하기

gpt-5 시리즈 이상에는 세 가지 매개변수 제한이 있습니다. temperature는 1이어야 하며, max_tokens 대신 max_completion_tokens를 사용하고, top_p는 전송하지 마십시오.

다음 단계

Claude Code 연결

APIYI를 통해 ANTHROPIC_BASE_URL를 설정하고 Claude Code를 구동합니다

Codex 연결

하나의 config.toml가 데스크톱 앱, IDE 플러그인 및 CLI를 모두 지원합니다

모델 목록 살펴보기

지원되는 모든 모델과 기능 요약표입니다

API 매뉴얼 읽기

전체 엔드포인트 레퍼런스, 오류 코드 및 디버깅입니다

FAQ

모델을 어떻게 전환합니까?

요청에서 model 매개변수만 변경하면 됩니다:
모델 ID는 하이픈이 아니라 점을 사용합니다. 문서 URL의 하이픈은 URL 안전성을 위한 대체 표기이며, 실제 모델 ID에는 점이 그대로 유지됩니다. 페이지 /models/qwen3-7-max는 모델 ID qwen3.7-max에 해당합니다. gpt-5-4-mini로 작성하면 404가 반환되며, 올바른 형식은 gpt-5.4-mini입니다.잘 모르겠으면 다음과 같이 나열하십시오: GET https://api.apiyi.com/v1/models.

지원되는 프로그래밍 언어는 무엇입니까?

APIYI는 OpenAI API 표준과 호환되며 OpenAI SDK가 지원하는 모든 언어를 지원합니다:
  • Python
  • JavaScript/TypeScript
  • Java
  • C#/.NET
  • Go
  • Ruby
  • PHP
  • 그 외 더 많습니다…

잔액은 어떻게 확인합니까?

콘솔에 로그인하여 다음을 확인하십시오:
  • 계정 잔액
  • 사용 내역
  • 사용 통계
또한 API를 통해 프로그램으로 조회할 수도 있습니다:
  • 잔액 조회 API: API를 통해 계정 잔액, 만료일 등 더 많은 정보를 가져옵니다
  • 잔액 알림 설정: 잔액이 부족할 때 자동으로 알림을 받아 서비스 중단을 방지합니다

문제가 발생하면 어떻게 합니까?

  1. 문제가 발생한 페이지를 열고, 오른쪽 상단의 페이지 복사를 눌러 오류와 함께 AI에 보내십시오
  2. API 설명서를 확인하십시오
  3. 일반적인 오류를 검토하십시오
  4. 지원팀에 문의하십시오: [email protected]
팁: API key를 안전하게 보관하고 콘솔에서 사용 로그를 정기적으로 확인하십시오. 모든 요청에는 비용 최적화를 위한 메시지 내역이 포함됩니다. 잘 사용하시기 바랍니다!