Skip to main content

오류

한 문장으로 요약하면: 이 오류는 APIYI가 아니라 OpenAI 자체 서버에서 반환됩니다. 현재 코드가 api.openai.com을(를) 호출하고 있으므로 OpenAI가 APIYI 키를 거부합니다. 키는 정상입니다. 요청 주소가 잘못되었습니다.

요청이 APIYI에 도달하지 않았음을 확인하는 방법

다음 두 가지 징후 중 하나만 확인되어도 확실합니다.
특히 AI 코딩 어시스턴트에게 통합 코드를 작성해 달라고 요청할 때 흔히 발생합니다. Codex, Cursor, Claude Code 및 이와 유사한 도구는 모델 이름 gpt-image-2.5를 확인하고 공식 OpenAI SDK 패턴을 기본값으로 사용하며, base_url을 SDK 기본값인 https://api.openai.com/v1로 둡니다. 붙여 넣는 키는 APIYI의 키입니다. 두 값은 일치하지 않습니다.

세 가지 해결 방법, 상황에 맞게 선택

가장 수고가 적은 방법은 에이전트가 코드를 작성하기 전에 APIYI를 “학습”하도록 하는 것입니다. 두 가지 수준의 스킬 팩을 사용할 수 있습니다.
1

사이트 전체 스킬 팩(먼저 설치)

에이전트가 아래 명령을 실행하여 APIYI 스킬 팩을 설치하도록 하십시오. 실패하면 https://docs.apiyi.com/skill.md을 직접 읽도록 지시하십시오.
이 파일은 AI를 위해 작성되었으며, 베이스 URL, 인증, 모델 명명 규칙 및 일반적인 문제를 설명합니다. 설치가 완료되면 에이전트가 작성하는 코드는 자동으로 base_urlhttps://api.apiyi.com/v1로 지정합니다.
2

전용 GPT-Image 스킬

GPT-Image-2.5 / 2 시리즈 에이전트 스킬 페이지에는 gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2을 포함한 6개 모델을 지원하는 즉시 사용 가능한 스킬이 제공됩니다. 두 개의 파일과 하나의 스크립트로 구성되며, --model을 사용하여 모델을 전환합니다. 텍스트-이미지 변환, 다중 이미지 융합 및 인페인팅이 모두 포함되어 있습니다.이를 Codex, OpenClaw, Claude Code 또는 셸 명령을 실행할 수 있는 코딩 에이전트에 넣은 다음 “이미지 생성: …”이라고 말하기만 하면 됩니다. 직접 베이스 URL을 수정할 필요가 없습니다.
다른 이미지 및 동영상 모델에도 각각 “에이전트 스킬” 페이지가 있으며, 해당 모델의 문서 폴더 아래에 정리되어 있습니다. 왼쪽 탐색 메뉴에서 모델을 찾고 “에이전트 스킬”이라는 이름의 하위 페이지를 확인하십시오.

직접 해결하기: 한 줄

Codex로 생성된 코드가 이미 있다면, 최소한으로 변경할 부분은 클라이언트에 base_url을 추가하는 것입니다. 나머지는 모두 그대로 두십시오.
그런 다음 요청이 실제로 APIYI에 도달하는지 확인하십시오. 응답에 모델 목록이 표시되면 완료된 것입니다.

후속 질문

다음 순서로 확인합니다.
  1. 여러 구성 위치: Codex가 생성한 프로젝트는 .env, 구성 파일 및 클라이언트 생성자에서 URL을 설정하는 경우가 많습니다. 한 곳만 변경하면 나머지는 기본값으로 남습니다.
  2. 환경 변수 우선순위: 시스템에 OPENAI_BASE_URL가 이미 다른 값으로 설정되어 있으면 코드에서 생략한 설정을 재정의합니다. 확인하려면 echo $OPENAI_BASE_URL을 실행합니다.
  3. 재시작하지 않음: 실행 중인 프로세스가 여전히 이전 구성을 사용하고 있습니다.
  4. 철자: apiyi이며, apiyii 또는 apiyl가 아닙니다.
가장 간단한 증명은 오류 메시지 자체입니다. platform.openai.com가 계속 표시되는 한 요청은 여전히 OpenAI로 전송되고 있습니다.
정확한 오류와 이 페이지를 함께 전달합니다. 모든 문서 페이지의 오른쪽 상단에는 “페이지 복사” 버튼이 있습니다. 페이지 내용과 오류를 AI에 붙여 넣으면 적용되지 않은 구성이 무엇인지 정확히 파악할 수 있습니다. 이것이 가장 빠른 문제 해결 방법입니다.
그때 키 자체를 확인하면 됩니다. 콘솔에서 “토큰” 페이지를 열고 키가 활성화되어 있는지, 잔액이 충분한지, 모델 허용 목록으로 인해 차단되지 않는지 확인합니다. 전체 확인 목록은 내 API 키가 유효하지 않은 이유는 무엇입니까?에서 확인할 수 있습니다.
텍스트-이미지 변환에는 gpt-image-2.5-flare, 편집 및 인페인팅에는 gpt-image-2.5-sunburst를 기본값으로 사용합니다. 두 모델은 가격과 매개변수가 동일합니다. 대량의 작업을 저렴한 비용으로 처리하려면 역방향 채널인 gpt-image-2.5-all을 사용합니다. GPT-Image 시리즈 에이전트 스킬 페이지의 비교 표에서 6개 모델을 모두 확인할 수 있습니다.

관련 항목

API 키가 유효하지 않은 이유는 무엇입니까?

모든 언어의 예시와 함께 기본 URL과 키가 일치해야 하는 이유를 설명합니다.

기본 URL은 어떻게 구성합니까?

OpenAI는 /v1, Claude는 루트 도메인, Gemini는 /v1beta를 사용합니다.

원클릭 통합이 있습니까?

문서를 AI 코딩 어시스턴트에 전달하면 통합을 수행하도록 할 수 있습니다.

GPT-Image-2.5 / 2 개요

매개변수, 과금, 통합 prompt 및 일반적인 오류를 설명합니다.