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에 제공할 수 있는 다섯 가지 진입점

코딩 에이전트를 위한 스킬, CLI 및 계약+레지스트리 경로는 모두 AI 개발자 키트에 설명되어 있습니다.
예를 들어 이 페이지의 일반 텍스트 버전은 https://docs.apiyi.com/en/getting-started.md입니다. 사이트의 모든 페이지에서 이 접미사를 지원합니다.

모든 페이지를 AI에 바로 보내기

모든 문서 페이지의 오른쪽 상단에는 페이지 복사 버튼이 있습니다. 버튼 옆의 화살표를 열면 더 많은 옵션이 표시됩니다. 문서 페이지 오른쪽 상단의 페이지 복사 메뉴입니다. 페이지 복사, Markdown으로 보기, ChatGPT, Claude, Perplexity 또는 Google AI Studio에서 열기 옵션이 표시됩니다 특정 모델에서 문제가 발생하면 가장 빠른 방법은 해당 모델의 페이지를 열고 페이지 복사를 누른 다음, 오류와 함께 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를 안전하게 보관하고 콘솔에서 사용 로그를 정기적으로 확인하십시오. 모든 요청에는 비용 최적화를 위한 메시지 내역이 포함됩니다. 잘 사용하시기 바랍니다!