오류
한 문장으로 요약하면: 이 오류는 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의 키입니다. 두 값은 일치하지 않습니다.세 가지 해결 방법, 상황에 맞게 선택
- ① Codex / 코딩 에이전트를 사용하는 경우: 스킬 설치
- ② 코더가 아닌 경우: AI에 프롬프트 전달
- ③ 통합이 필요 없는 경우: 웹에서 생성
가장 수고가 적은 방법은 에이전트가 코드를 작성하기 전에 APIYI를 “학습”하도록 하는 것입니다. 두 가지 수준의 스킬 팩을 사용할 수 있습니다.
1
사이트 전체 스킬 팩(먼저 설치)
에이전트가 아래 명령을 실행하여 APIYI 스킬 팩을 설치하도록 하십시오. 실패하면 이 파일은 AI를 위해 작성되었으며, 베이스 URL, 인증, 모델 명명 규칙 및 일반적인 문제를 설명합니다. 설치가 완료되면 에이전트가 작성하는 코드는 자동으로
https://docs.apiyi.com/skill.md을 직접 읽도록 지시하십시오.base_url을 https://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을 추가하는 것입니다. 나머지는 모두 그대로 두십시오.
후속 질문
base_url을 변경했지만 여전히 같은 오류가 발생합니다. 이유가 무엇입니까?
base_url을 변경했지만 여전히 같은 오류가 발생합니다. 이유가 무엇입니까?
다음 순서로 확인합니다.
- 여러 구성 위치: Codex가 생성한 프로젝트는
.env, 구성 파일 및 클라이언트 생성자에서 URL을 설정하는 경우가 많습니다. 한 곳만 변경하면 나머지는 기본값으로 남습니다. - 환경 변수 우선순위: 시스템에
OPENAI_BASE_URL가 이미 다른 값으로 설정되어 있으면 코드에서 생략한 설정을 재정의합니다. 확인하려면echo $OPENAI_BASE_URL을 실행합니다. - 재시작하지 않음: 실행 중인 프로세스가 여전히 이전 구성을 사용하고 있습니다.
- 철자:
apiyi이며,apiyii또는apiyl가 아닙니다.
platform.openai.com가 계속 표시되는 한 요청은 여전히 OpenAI로 전송되고 있습니다.Codex에서는 이미 APIYI로 전환했다고 하는데 오류가 바뀌지 않습니다.
Codex에서는 이미 APIYI로 전환했다고 하는데 오류가 바뀌지 않습니다.
정확한 오류와 이 페이지를 함께 전달합니다. 모든 문서 페이지의 오른쪽 상단에는 “페이지 복사” 버튼이 있습니다. 페이지 내용과 오류를 AI에 붙여 넣으면 적용되지 않은 구성이 무엇인지 정확히 파악할 수 있습니다. 이것이 가장 빠른 문제 해결 방법입니다.
요청이 APIYI에 도달한 후에도 키가 계속 거부되면 어떻게 합니까?
요청이 APIYI에 도달한 후에도 키가 계속 거부되면 어떻게 합니까?
그때 키 자체를 확인하면 됩니다. 콘솔에서 “토큰” 페이지를 열고 키가 활성화되어 있는지, 잔액이 충분한지, 모델 허용 목록으로 인해 차단되지 않는지 확인합니다. 전체 확인 목록은 내 API 키가 유효하지 않은 이유는 무엇입니까?에서 확인할 수 있습니다.
gpt-image-2.5에는 어떤 모델 이름을 사용해야 합니까?
gpt-image-2.5에는 어떤 모델 이름을 사용해야 합니까?
텍스트-이미지 변환에는
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 및 일반적인 오류를 설명합니다.