KO ▾

이미지 파이프라인용 무검열 텍스트 API

API 키 받기

이미지 생성 API OpenAI 스타일: 텍스트 전용

OpenAI 사용자가 호출할 수 있는 이미지 생성 API를 검색했다면 먼저 알아두어야 할 것은 이 서비스가 텍스트 채팅 전용으로 OpenAI와 호환된다는 점입니다. 이미지는 생성하지 않습니다.

업데이트

주요 포인트

  • 호환 가능하다는 것은 OpenAI SDK가 채팅 완료에 사용될 수 있다는 뜻이지, 이미지 엔드포인트가 존재한다는 뜻이 아닙니다.
  • POST /v1/chat/completions과 GET /v1/models만 사용 가능하며, 단일 모델 ID는 uncensored입니다.
  • 이미지 작업을 위한 실용적인 용도는 이미 사용하는 이미지 모델용 프롬프트를 작성하고 다듬는 것입니다.
  • 아래 예시에서 프롬프트 작성 호출 1,000회 비용은 약 15센트입니다.
빈 사진 액자에 리본으로 연결된 텍스트 터미널, 이미지 도구에 입력할 텍스트 출력을 표시

짧은 답변

image gen api openai이라는 구문은 두 가지 다른 의미를 가질 수 있으며 이를 구분하는 것이 도움이 됩니다. 하나는 OpenAI의 자체 이미지 생성 서비스로, OpenAI 계정으로 접근합니다. 다른 하나는 기존 SDK와 도구가 작동하도록 OpenAI 요청 형식을 따르는 모든 서비스입니다. 이 사이트는 텍스트 전용인 두 번째 유형입니다.

여기서 제공하는 것은 호스팅된 무검열 텍스트 LLM API입니다. OpenAI 클라이언트를 아래 base URL에 연결하고 모델을 uncensored로 설정하면 채팅 완료를 받습니다. 픽셀은 반환되지 않습니다. 이미지, 오디오 또는 비디오 생성, 임베딩, 파인튜닝이 없으며, 이 페이지에 설명된 내용에 이러한 기능이 추가될 계획도 없습니다.

호환되는 것과 호환되지 않는 것

"호환"이라는 단어는 마케팅에서 과장되므로 정확한 범위를 명시합니다. base URL은 https://api.imagegenapi.com/v1이며, 인증은 Authorization: Bearer <key>입니다. 두 가지 메서드가 존재합니다.

엔드포인트사용 가능참고
POST /v1/chat/completions예스트리밍, 도구 호출, JSON 모드
GET /v1/models예uncensored 목록
이미지 생성 엔드포인트아니요텍스트 전용 서비스
임베딩, 오디오, 파인튜닝아니요제공되지 않음

이 Base URL의 이미지 경로로 코드를 호출하면 이미지가 아닌 오류가 발생합니다. 위의 두 메서드 이외의 모든 OpenAI 기능도 마찬가지입니다. 알고 계신 샘플링 제어는 작동합니다: temperature, top_p, stop, seed 및 페널티가 전달되며, 프롬프트와 완료 텍스트를 합쳐 100,000 토큰 컨텍스트 윈도우를 사용할 수 있습니다.

정체성에 대해 명확히 하는 것도 중요합니다. uncensored 뒤의 모델은 독립적인 제공자가 실행하는 단일 오픈 웨이트 모델입니다. 이는 OpenAI의 API가 아니며, OpenAI 모델을 프록시하지 않으며, OpenAI와 제휴 관계가 아닙니다. 이 사이트의 해당 페이지 GPT 이미지 API 및 무검열 텍스트는 이미지 모델 이름의 관점에서 동일한 구분을 다룹니다.

왜 이 질문이 나오는지

사람들은 이해할 만한 이유로 이런 페이지에 도달합니다. 이미지 도구는 텍스트 프롬프트로 구동되고, 텍스트 프롬프트는 언어 모델이 작성하며, 많은 언어 모델 게이트웨이는 하나의 요청 형식을 공유합니다. 자연스러운 추측은 하나의 API가 둘 다 수행한다는 것입니다.

실제로 두 작업은 별도의 키, 별도의 가격 책정, 별도의 규칙을 가진 별도의 시스템입니다. 이미지 서비스는 프롬프트를 받아 이미지를 반환합니다. 텍스트 서비스는 메시지를 받아 더 많은 텍스트를 반환합니다. 둘 사이의 연결은 텍스트를 한 곳에서 다른 곳으로 전달하는 당신 또는 당신이 작성한 스크립트입니다. 이렇게 보면 유용한 질문은 "이 API가 이미지를 생성하는가"에서 "이미 사용하는 이미지 모델용 더 나은 프롬프트를 작성할 수 있는가"로 바뀝니다.

이것은 실제 사용 사례이며, 무검열 텍스트 모델이 중요한 곳입니다. 범용 어시스턴트는 성숙한 픽션 테마, 이야기 설정의 폭력 또는 다크 미학을 다루는 프롬프트 요청을 다시 쓰거나, 부드럽게 하거나, 거부하는 경우가 많습니다. 합법적인 성인 요청을 거부 없이 답변하도록 조정된 모델은 일반적으로 요청된 대로 작성 작업을 수행합니다. 단, 미성년자가 관련된 성적 콘텐츠는 어떤 맥락에서도 허용되지 않습니다.

텍스트 API를 사용하여 이미지 프롬프트 작성하기

작동하는 작은 예시를 제시합니다. 모델에 상세한 프롬프트를 요청하고, 그 결과를 사용하는 이미지 생성기에 붙여넣습니다. 이 코드는 이 base URL에 대해 공식 OpenAI Python SDK를 사용합니다.

from openai import OpenAI

client = OpenAI(base_url="https://api.imagegenapi.com/v1", api_key="YOUR_KEY")

reply = client.chat.completions.create(
    model="uncensored",
    temperature=0.8,
    messages=[
        {"role": "system", "content": "You write prompts for text-to-image models. Reply with one paragraph: subject, composition, lighting, palette, lens or style. No preamble."},
        {"role": "user", "content": "A ruined lighthouse at dusk for a dark fantasy book cover."},
    ],
)
print(reply.choices[0].message.content)

명령줄에서 동일한 호출:

curl https://api.imagegenapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a one-paragraph image prompt: a ruined lighthouse at dusk, dark fantasy cover art."}]}'

출력을 사용 가능하게 만들기

이미지 생성기는 허용하는 내용이 다르므로 시스템 메시지로 결과를 조정하세요. 고정된 구조, 단어 제한, 피해야 할 항목 목록을 요청하세요. 파이프라인 내에서 프롬프트가 필요한 경우 response_format을 type json_object로 설정하고 prompt 및 negative과 같은 키를 요청하세요. 그런 다음 파싱하여 필드를 이미지 클라이언트에 전달하세요. seed을 설정하고 낮은 temperature을 사용하면 단어 선택을 반복할 때 더 반복 가능한 출력을 얻을 수 있습니다.

실제 숫자가 포함된 배치 워크플로우

1,000개의 장면에 대한 프롬프트를 생성한다고 가정해 봅시다. 각 요청은 약 300개의 토큰(지시사항과 짧은 장면 노트)을 보내고 약 200개의 토큰의 프롬프트를 받습니다. 가격 책정은 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.50입니다.

  • 하나의 요청, 입력: 300 / 1,000,000 x $0.15 = $0.000045.
  • 하나의 요청, 출력: 200 / 1,000,000 x $0.50 = $0.0001.
  • 하나의 요청 총합: $0.000145.
  • 1,000개의 요청: 1,000 x $0.000145 = $0.145.

따라서 프롬프트 1,000개당 비용은 약 14.5센트이며, 이미지 생성 자체 비용에 비해 텍스트 처리 비용은 일반적으로 작은 비율을 차지합니다. 이미지 생성 비용은 해당 제공업체에 확인하세요. 전체 키는 최대 8개의 동시 요청과 분당 300개의 요청을 허용하므로, 작은 워커 풀로 1,000개의 요청을 몇 분 안에 처리할 수 있습니다. HTTP 429는 대기하여 처리하세요. Retry-After: 5 헤더는 일시적 과부하 시 대기해야 하는 시간을 알려줍니다.

이 모든 것을 지불 없이 시도할 수 있습니다. 가입 후 API 키 페이지에서 7일 동안 유효한 원클릭 $0.50 체험 크레딧을 받을 수 있습니다. 장기적으로 충전은 $20부터 $500까지 진행되며, 암호화폐(TRC20의 USDT 또는 Base의 USDC)로 결제합니다. 보너스 티어는 가격 책정 페이지를 참조하세요.

피해야 할 실수

누군가가 이미지 작업을 위해 OpenAI 형식의 엔드포인트를 사용하려고 할 때 몇 가지 오류가 반복적으로 나타납니다.

  • 이미지 경로를 호출하고 그림을 기대하기. 여기서는 문서화된 두 가지 메서드만 존재합니다. 재시도하기보다 오류 본문을 확인하세요. 재시도는 결과를 바꾸지 않습니다.
  • 텍스트 모델에 "그림을 그려"라고 요청하기. ASCII 아트, 설명 또는 사과를 받을 수 있습니다. 그림이 필요하다면 모델이 작성한 프롬프트를 실제 이미지 생성기에 보내세요.
  • 모델 목록 건너뛰기. 빠른 GET /v1/models 호출은 키가 작동하고 유일한 모델이 uncensored임을 확인합니다. 비용은 없습니다.
  • 429 응답 무시하기. 체험 키는 2개의 동시 요청만 허용하므로 10개의 워커로 루프를 돌리면 빠르게 실패합니다. 워커 수를 제한하거나 짧은 대기 시간을 추가하세요.
  • 매우 큰 본문 보내기. 요청당 제한은 8 MB입니다. 프롬프트 작성 호출은 매우 작으므로 이는 거의 문제가 되지 않지만, 붙여넣은 문서가 이 제한에 도달할 수 있습니다.

이 중 어느 것도 수정하기 어렵지 않으며, 더 큰 도구에 연결하기 전에 10줄 테스트 스크립트를 실행하는 것이 가장 빠른 해결책입니다.

다른 서비스가 더 적합한 경우

선택에 대해 실용적으로 접근하세요. 그림 자체가 필요하다면 이미지 제공자가 필요하며, OpenAI는 여러 제공자 중 하나입니다. 현재 제공되는 기능의 세부 정보는 해당 문서와 가격 책정을 확인하세요. 유일한 목표가 주류 스타일의 깔끔한 프롬프트라면 표준 어시스턴트만으로도 충분하며 이 서비스가 전혀 필요 없을 수 있습니다.

텍스트 단계가 병목 현상일 때 이 API가 더 적합합니다: 사용하는 어시스턴트가 프롬프트 요청을 거부하거나 약화시키거나, 예측 가능한 토큰당 가격으로 많은 양의 프롬프트가 필요하거나, 클라이언트 코드 수정 없이 합법적인 성인용 픽션, 롤플레이 및 컴패니언 도구를 위한 OpenAI 호환 엔드포인트가 필요한 경우. 전체 파라미터 세부 정보는 문서에 요청 형식과 오류 코드가 있습니다.

한 가지 더 실용적인 참고 사항: 이 API로 보내는 프롬프트는 학습에 사용되지 않습니다. 그래도 호스팅된 서비스는 자신의 머신 외부에 있으므로 웹 폼에 붙여넣지 않을 비밀 정보는 보내지 마세요.

질문과 답변

이것이 OpenAI 이미지 API인가요?

아니요. 채팅 완료용 OpenAI 요청 형식을 복사한 독립적인 텍스트 LLM API입니다. 이미지를 생성하지 않으며 OpenAI에서 운영하지 않습니다.

OpenAI SDK를 사용할 수 있나요?

네, 텍스트 채팅에 사용할 수 있습니다. Base URL을 https://api.imagegenapi.com/v1로 설정하고 API 키를 사용하며, 모델 ID는 uncensored를 사용하세요.

이미지를 설명하거나 분석할 수 있나요?

아니요. 텍스트만 입력받고 텍스트만 반환합니다. 이미지 입력, 이미지 출력, 오디오 및 비디오는 지원되지 않습니다.

그렇다면 이미지 작업은 어떻게 하나요?

선택한 이미지 생성기의 프롬프트를 작성, 확장 또는 번역하는 데 사용하고, JSON 형식의 구조화된 프롬프트 데이터를 생성하세요.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 Base URL을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기