메인 콘텐츠로 건너뛰기

오류

한 문장으로 요약하면: 이 오류는 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의 키입니다. 두 설정은 서로 일치하지 않습니다.

상황에 따라 선택하는 세 가지 해결 방법

가장 간편한 방법은 코드를 작성하기 전에 Agent가 APIYI를 “학습”하게 하는 것입니다. 두 가지 수준의 Skill 팩을 사용할 수 있습니다.
1

사이트 전체에 적용되는 Skill 팩(먼저 설치)

아래 명령을 실행해 APIYI Skill 팩을 설치하도록 Agent에 요청합니다. 설치에 실패하면 https://docs.apiyi.com/skill.md을 직접 읽도록 안내합니다.
이 파일은 AI를 위해 작성되었으며, 기본 URL, 인증, 모델 이름 지정 규칙과 일반적인 주의 사항을 설명합니다. 설치하면 작성되는 코드가 자동으로 base_url를 https://api.apiyi.com/v1에 지정합니다.
2

GPT-Image 전용 Skill

GPT-Image-2.5 / 2 시리즈 Agent Skill 페이지에는 바로 사용할 수 있는 Skill이 제공됩니다. 파일 두 개와 스크립트 하나로 2.6 / 2.5 / 2 시리즈 전체를 지원하며(기본값은 gpt-image-2.6-all), --model로 전환합니다. 텍스트-이미지 변환, 여러 이미지 융합, 인페인팅을 모두 지원합니다.이 Skill을 Codex, OpenClaw, Claude Code 또는 셸 명령을 실행할 수 있는 코딩 Agent에 넣고 “…이미지를 생성해 줘”라고 말하면 됩니다. 기본 URL을 직접 다룰 필요가 없습니다.
다른 이미지 및 동영상 모델에도 각각 해당 모델의 문서 폴더에 “Agent Skill” 페이지가 있습니다. 왼쪽 탐색 메뉴에서 모델을 찾은 다음 “Agent Skill”이라는 하위 페이지를 확인합니다.

직접 수정하기: 한 줄

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

후속 질문

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

관련 문서

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

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

기본 URL을 구성하는 방법은 무엇입니까?

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

원클릭 통합을 지원합니까?

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

GPT-Image-2.5 / 2 개요

매개변수, 가격, 통합 prompt 및 일반적인 오류를 다룹니다.