내 도구에서 이미지 생성

OfoxAI의 GPT Image 모델로 이미지를 생성하고 싶습니다. OfoxAI 콘솔에서 API 키는 이미 만들었습니다. 저는 기술에 익숙하지 않으니 한 단계씩 안내해 주십시오. 각 단계를 시작하기 전에 무엇을 하는지, 다음에 무엇을 하는지 쉬운 말로 알려 주십시오.

[1단계: 키를 안전하게 보관하도록 도와주십시오]
1. 현재 폴더에 .env 파일을 만들고 OFOX_API_KEY= 한 줄만 넣어 주십시오(값은 비워 둡니다). 현재 폴더가 코드 저장소라면 .env를 .gitignore에 추가해 주십시오.
2. 파일이 어디에 있고 어떻게 여는지 알려 주십시오. = 뒤에 키를 제가 직접 붙여 넣고 저장하겠습니다.
3. 이 채팅으로 키를 보내라고 요청하지 마십시오. 제가 실수로 붙여 넣으면, 콘솔에서 그 키를 삭제하고 새로 만들라고 알려 주십시오.
4. 제가 "완료"라고 말할 때까지 기다린 뒤 계속해 주십시오.

[2단계: 이미지 생성 준비]
5. .env에서 OFOX_API_KEY를 읽어 POST https://api.ofox.io/v1/images/generations 를 호출해 이미지를 생성하는 작은 스크립트를 작성해 주십시오.
6. 모델은 openai/gpt-image-2.5-flare, quality는 low, size는 1024x1024로 하고, 클라이언트 타임아웃은 600초로 설정해 주십시오.
7. 반환되는 data[0].b64_json은 순수 base64입니다. 디코딩하여 현재 폴더 안의 images 폴더에 PNG로 저장해 주십시오.
8. 키를 출력하지 말고, 스크립트에 직접 적지도 마십시오.

[3단계: 한 장 시험 생성]
9. 먼저 "흰 테이블 위의 빨간 사과"를 생성하고, 이미지가 어디에 저장되었으며 어떻게 여는지 알려 주십시오.
10. 그 후에는 제가 이미지를 설명할 때마다 이 스크립트로 한 장씩 생성하고 저장 위치를 알려 주십시오. 제가 "더 높은 품질"이라고 하면 quality를 medium 또는 high로 바꾸고, 비용이 늘고 시간도 오래 걸린다는 점을 알려 주십시오.

[실패했을 때]
11. HTTP 상태 코드와 전체 오류(error.message와 request_id 포함)를 출력하고, https://ofox.io/ko/docs/develop/models/gpt-image#errors 에서 원인을 찾은 뒤 한 가지만 바꿔 다시 시도해 주십시오.
12. 두 번 수정해도 같은 오류가 계속되면 멈추고, 문제를 쉬운 말로 설명한 뒤 OfoxAI에 문의할 수 있도록 request_id와 오류 메시지 원문을 알려 주십시오.
13. 이미지는 한 번에 한 장씩 생성하고, 임의로 여러 번 반복해서 재시도하지 마십시오(요청마다 비용이 청구됩니다).

이 프로젝트에 OfoxAI GPT Image 이미지 생성 기능을 추가하고 싶습니다. OfoxAI 콘솔에서 API 키는 이미 만들었습니다. 저는 기술에 익숙하지 않으니 한 단계씩 안내해 주십시오. 각 단계를 시작하기 전에 무엇을 하는지, 다음에 무엇을 하는지 쉬운 말로 알려 주십시오.

[1단계: 키를 안전하게 보관하도록 도와주십시오]
1. 프로젝트에 .env 파일을 만들고 OFOX_API_KEY= 한 줄만 넣어 주십시오(값은 비워 둡니다).
2. .env를 .gitignore에 추가하여 커밋되거나 업로드되지 않도록 해 주십시오.
3. 파일이 어디에 있고 어떻게 여는지 알려 주십시오. = 뒤에 키를 제가 직접 붙여 넣고 저장하겠습니다.
4. 이 채팅으로 키를 보내라고 요청하지 마십시오. 제가 실수로 붙여 넣으면, 콘솔에서 그 키를 삭제하고 새로 만들라고 알려 주십시오.
5. 제가 "완료"라고 말할 때까지 기다린 뒤 계속해 주십시오.

[2단계: 코드 작성]
6. 공식 OpenAI SDK로 OfoxAI의 이미지 엔드포인트를 호출해 주십시오. base_url은 https://api.ofox.io/v1 이며, 키는 .env의 OFOX_API_KEY에서 읽습니다.
 - 텍스트로 이미지 생성: POST /v1/images/generations
 - 편집, 여러 장 합성, 부분 수정: POST /v1/images/edits (multipart 업로드)
7. 전체 모델 ID를 사용해 주십시오: openai/gpt-image-2.5-flare (편집에는 openai/gpt-image-2.5-sunburst).
8. quality는 항상 명시적으로 전달하고, 개발 중에는 low를 사용해 주십시오. 생략하면 모델이 등급을 스스로 고릅니다.
9. size는 다음을 모두 만족해야 합니다: 너비와 높이가 16으로 나누어떨어짐, 긴 변 ≤ 3840, 종횡비 1:3에서 3:1 사이, 총 픽셀 수 ≥ 655,360.
10. 결과는 data[0].b64_json에 data: 접두사 없는 순수 base64로 들어 있습니다. 디코딩하여 이미지 파일로 저장해 주십시오.
11. 클라이언트 타임아웃을 600초로 설정해 주십시오.
12. response_format, input_fidelity, style은 보내지 마십시오.
13. 키를 코드, 로그, 오류 메시지에 절대 남기지 말고, 요청을 출력할 때는 Authorization 헤더를 가려 주십시오.

[3단계: 테스트]
14. quality=low, size=1024x1024로 실제 호출을 한 번 하여 200이 반환되고 이미지가 열리는지 확인한 뒤, 이미지가 어디에 저장되었는지 알려 주십시오.
15. 테스트 중에는 한 번에 한 장씩 생성하고, 반복문으로 일괄 테스트하지 마십시오(요청마다 비용이 청구됩니다).

[실패했을 때]
16. HTTP 상태 코드와 전체 응답 본문(error.message와 request_id 포함)을 출력하고, https://ofox.io/ko/docs/develop/models/gpt-image#errors 에서 원인을 찾아 주십시오.
17. 429는 잠시 기다린 뒤 다시 시도하고, 그 밖의 오류는 같은 요청을 그대로 재시도하지 말고 먼저 요청을 수정해 주십시오.
18. 두 번 수정해도 같은 오류가 계속되면 멈추고, 문제를 쉬운 말로 설명한 뒤 OfoxAI에 문의할 수 있도록 request_id와 오류 메시지 원문을 알려 주십시오.

[출시 전 점검]
19. 제가 "출시 준비"라고 말하면 다음 항목을 하나씩 점검하고 결과를 알려 주십시오: 코드와 커밋 기록에 키가 없는지, .env가 .gitignore에 있는지, 모든 요청에 quality를 전달하는지, 타임아웃이 600초 이상인지, 오류 발생 시 상태 코드, 원본 오류 메시지, request_id를 출력하는지.

참고 자료:
- 이 시리즈의 값과 제약: https://ofox.io/ko/docs/develop/models/gpt-image
- 엔드포인트 공통 구조: https://ofox.io/ko/docs/api/openai/images