Flux API 키: 정의와 텍스트 API의 위치
Flux API 키는 이미지 생성 서비스의 자격 증명이며, 이 사이트는 이를 판매하지 않습니다. 이 사이트가 판매하는 것은 다른 키로, 이미지 모델에 공급할 프롬프트를 작성하고 확장할 수 있는 호스팅 텍스트 LLM API용 키입니다.
업데이트됨

주요 포인트
- Flux 이미지 서비스용 키와 텍스트 LLM API용 키는 두 개의 별도 제공업체에서 발급하는 서로 다른 것입니다.
- 이 사이트는 텍스트 전용입니다: 이미지, 오디오 또는 비디오 생성이 없으며 이미지 모델 벤더가 운영하지 않습니다.
- 프롬프트 작성은 텍스트 작업이며 토큰 단위로 청구되므로 이미지 키와 함께 텍스트 키가 유용합니다.
- 어떤 OpenAI 클라이언트에서도 Base URL과 키 하나만 변경하면 시작할 수 있으며, 무료 체험 크레딧으로 첫 테스트를 진행할 수 있습니다.
사람들이 일반적으로 Flux 키라고 의미하는 것
Flux는 텍스트-이미지 모델 계열의 이름입니다. 누군가가 검색창에 flux api key를 입력할 때, 그들은 코드가 이미지 모델 중 하나를 호스팅하는 서비스에 프롬프트를 보내고 그림을 받아올 수 있는 자격 증명을 거의 항상 원합니다. 해당 자격 증명은 선택한 이미지 엔드포인트를 운영하는 회사에서 제공됩니다. 이는 해당 계정, 청구 및 약관에 묶여 있습니다.
이 구문은 약간 다른 방식으로 사용되므로, 키를 어디든 붙여넣기 전에 이를 정리하는 것이 도움이 됩니다:
- Flux 모델을 제공하는 이미지 호스트에서 발급한 키로, 이미지를 반환하는 요청에 사용됩니다.
- 로컬 또는 자체 호스팅 환경용 키로, 토큰을 직접 생성하며 아무것도 머신 외부로 나가지 않습니다.
- 프롬프트를 작성하는 텍스트 모델과 같은 파이프라인의 다른 도구용 키로, 프로젝트 이름 때문에 Flux라고만 불립니다.
첫 두 개만 이미지를 생성합니다. 세 번째는 이 사이트의 위치입니다. 우리는 호스팅된 OpenAI 호환 LLM API를 실행하며, 여기서 발급한 키는 해당 API에서만 작동하고 다른 곳에서는 작동하지 않습니다.
이미지 키가 채팅 모델을 호출하지 않는 이유
두 종류의 키는 모두 긴 문자열이며 Authorization 헤더에 전송하기 때문에 비슷해 보이지만, 서로 다른 문을 엽니다. 이미지 제공업체의 키는 이미지 제공업체에서 검증합니다. 채팅 엔드포인트에 전송하면 인증 오류가 발생하며, 그 반대도 동일합니다: 이 사이트의 키는 이미지 호스트에 전송하면 오류를 반환합니다.
요청 본문도 다릅니다. 이미지 호출에는 보통 프롬프트, 크기(해상도), 시드 및 이미지 수가 포함됩니다. 채팅 호출에는 역할이 있는 메시지 목록이 포함되어 텍스트를 반환합니다. 공유된 스키마가 없으므로 서로 간에 번역할 것이 없습니다. 이미지 호스트에서 작동하는 스크립트가 있다면 해당 스크립트와 키를 그대로 유지하세요. 앞에 텍스트 호출을 별도 단계로 추가하세요.
이 서비스가 수행하지 않는 작업
기대를 명확히 하기 위해: 여기서의 API는 텍스트 전용입니다. 이미지, 오디오 또는 비디오를 생성하지 않으며, 임베딩을 생성하지 않고, 파인튜닝을 제공하지 않습니다. 어떤 모델 벤더의 공식 API가 아니며 벤더 간 라우터도 아닙니다. 합법적인 성인 사용에 콘텐츠 거부 없이 답변하도록 조정된 하나의 오픈 웨이트 모델을 제공하며, 독립적인 제공업체가 운영합니다. 전달하는 모델 ID는 uncensored입니다.
이미지 키 옆에서 텍스트 API가 차지하는 위치
프롬프트 작성이 명확한 접점입니다. 이미지 모델은 주제, 배경, 렌즈, 조명, 색상, 분위기 등 구체적이고 구조화된 설명에 잘 반응합니다. 대부분의 사람들은 이를 직접 작성한 후 나쁜 결과가 나오면 다시 작성합니다. 텍스트 모델은 초안을 작성하거나, 세 단어의 아이디어를 전체 설명으로 확장하거나, 당신이 커피를 마시러 가는 동안 주제에 대한 20가지 변형을 생성할 수 있습니다.
다음과 같은 작업에 잘 맞습니다:
- 확장. 시스템 메시지에서 한 번 설정한 스타일로 짧은 아이디어를 상세한 프롬프트로 변환하세요.
- 변형. 하나의 주제에 대한 10가지 다른 버전을 요청하고, 스크립트에서 반복할 수 있는 JSON 목록으로 반환받으세요.
- 정리. 고객이 작성한 지저분한 프롬프트를 이미지 모델이 더 잘 처리할 수 있도록 다시 작성하세요.
- 스크립트 및 캡션. 그림 옆에 들어갈 내레이션, 샷 리스트 또는 캡션을 작성하세요.
여기의 모델은 기본적으로 거부하지 않으므로, 사용이 합법적이고 성인 대상이라면 다른 호스팅 모델이 종종 거부하는 픽션, 캐릭터 디자인 및 성숙한 주제에 적합합니다. 모든 곳에서 적용되는 하나의 하드 제한이 있습니다: 미성년자가 관련된 성적 콘텐츠는 허용되지 않습니다. 그런 요청은 우리가 어떤 형태로든 지원하지 않는 것입니다.
1분 이내 첫 호출
Base URL과 키를 교체하면 모든 OpenAI SDK 또는 HTTP 클라이언트가 작동합니다. 채팅 엔드포인트는 POST /v1/chat/completions이며, GET /v1/models은 모델을 나열합니다. curl과 Python으로 동일한 요청은 다음과 같습니다.
curl https://api.fluxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
{"role": "user", "content": "a lighthouse in a storm, painterly"}
]
}'
from openai import OpenAI
client = OpenAI(
base_url="https://api.fluxapikey.com/v1",
api_key="YOUR_KEY",
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
{"role": "user", "content": "a lighthouse in a storm, painterly"},
],
)
print(reply.choices[0].message.content)
반환되는 문자열은 해당 서비스의 고유 키를 사용하여 이미지 서비스에 전달합니다. 두 키는 서로 직접 연결되지 않습니다. 스트리밍, 함수 호출 및 JSON 모드를 포함한 모든 파라미터 목록은 API 문서를 참조하세요.
두 키가 모두 필요한가요?
무엇을 구축하는지에 따라 다릅니다. 아래 표는 결정하는 빠른 방법입니다.
| 목표 | 이미지 키 | 텍스트 키 |
|---|---|---|
| 직접 작성한 프롬프트에서 이미지 생성 | 예 | 아니요 |
| 모델이 작성하거나 확장한 프롬프트에서 이미지 생성 | 예 | 예 |
| 스토리, 대화 또는 스크립트만 작성 | 아니요 | 예 |
| 성인용 채팅 또는 역할극 앱 구축 | 아니요 | 예 |
| 수백 개의 프롬프트 변형을 일괄 생성 | 선택 사항 | 예 |
자신의 프롬프트만 입력하고 만족한다면 텍스트 키는 큰 도움이 되지 않습니다. 오후 내내 프롬프트를 수정하거나 대용량이 필요한 경우, 이 키는 비용을 빠르게 회수합니다. 미디어 단계 앞에 텍스트 단계를 배치하는 동일한 개념을 따르는 비디오 워크플로우에서 텍스트 LLM 사용에 대한 짧은 가이드도 있습니다.
키를 혼동하여 발생하는 실수
두 서비스 환경에서의 대부분의 문제는 무엇을 찾아야 하는지 알면 작고 쉽게 발견할 수 있습니다.
- 잘못된 Base URL. 클라이언트가 여전히 이전 호스트를 가리키면 새 키가 거부됩니다. Base URL이
/v1로 끝나고 위의 예제와 일치하는지 확인하세요. - 잘못된 모델 이름. 여기서 유일한 모델 ID는
uncensored입니다. 이미지 모델의 이름을 전달하면 이 API에 해당 모델이 없기 때문에 오류가 반환됩니다. - 하나의 환경 변수에 키 저장. 각 서비스에 고유한 변수를 제공하세요. 예를 들어
TEXT_API_KEY과IMAGE_API_KEY과 같이요. 하나의 이름을 공유하면 키가 잘못된 호스트로 전송됩니다. - 응답에서 이미지를 기대함. 응답은
choices[0].message.content의 일반 텍스트입니다. 이미지가 필요하면 해당 텍스트를 두 번째 호출로 이미지 서비스에 보내야 합니다. - 429 무시. 8개를 초과하는 동시 요청 버스트는 오류 코드
concurrency와 함께 429를 반환하고, 분당 300개를 초과하는 요청은rate_limited을 반환합니다. 잠시 후 다시 시도하세요. 스트리밍된 요청은 스트림이 끝날 때까지 슬롯을 유지하므로 더 이상 읽지 않는 스트림을 닫으세요.
시험용 키의 한도가 낮습니다: 동시 요청 2개, 분당 60개. 이는 프롬프트 작성 단계를 직접 테스트하기에 충분하지만, 대량 작업은 선불 크레딧이 충전된 키를 기다려야 합니다.
프롬프트 작성 비용
청구 방식은 토큰 단위 선불이며, 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 구독은 없습니다. 프롬프트 작업은 규모가 작아 비용도 적습니다. 시스템 메시지 및 아이디어(입력)로 600 토큰, 확장된 프롬프트(출력)로 250 토큰을 사용하는 요청을 예로 들어보겠습니다. 입력 비용은 600 / 1,000,000 x $0.15 = $0.00009입니다. 출력 비용은 250 / 1,000,000 x $0.50 = $0.000125입니다. 요청 한 건당 비용은 $0.000215입니다.
따라서 1,000건의 요청 묶음 비용은 약 $0.215입니다. 회원가입 후 키 페이지에서 클릭 한 번으로 청구할 수 있는 $0.50 무료 체험 크레딧은 약 2,300건의 요청을 커버할 수 있습니다(0.50 / 0.000215). 카드가 필요 없으며, 7일 동안 유효합니다. 실패하거나 거부된 요청에는 요금이 부과되지 않으며, 나중에 추가한 선불 크레딧은 소멸하지 않습니다. 자세한 내용은 요금제 페이지에서 확인하세요.
텍스트 키 가져오기
Google 또는 이메일과 비밀번호로 회원가입한 후 API 키 페이지를 엽니다. 먼저 테스트해 보고 싶다면 해당 페이지에서 무료 체험 크레딧을 청구하세요. 유료 충전 금액은 $20부터 $500까지이며, 정수 단위로 가능합니다. $50 이상 충전 시 +5%, $100 이상 시 +10%, $200 이상 시 +15% 보너스가 제공됩니다. TRC20 네트워크의 USDT 또는 Base 네트워크의 USDC로 결제할 수 있습니다.
키는 클라이언트 측 코드나 공개 저장소에 포함하지 마세요. 전송한 프롬프트는 학습에 사용되지 않지만, 유출된 키로 크레딧이 소모될 수 있습니다. 전체 키는 최대 8개의 동시 요청과 분당 300개의 요청을 처리할 수 있으므로, 프롬프트 묶음을 추가 작업 없이 병렬로 실행할 수 있습니다.
더 많은 가이드
질문과 답변
이 키로 Flux로 이미지를 생성할 수 있나요?
아니요. 이 키는 해당 사이트의 텍스트 API에서만 작동합니다. 이미지 생성에는 이미지 모델을 호스팅하는 제공업체의 키가 필요합니다.
이것은 공식 Flux API인가요?
아니요. 이는 독립적으로 호스팅되는 OpenAI 호환 텍스트 API로, uncensored라는 하나의 모델만 사용합니다. 이미지 모델 벤더가 직접 운영하지 않으며, 그들의 서비스를 재판매하지도 않습니다.
텍스트 모델이 내 이미지 도구를 위한 프롬프트를 작성할 수 있나요?
네. 시스템 메시지에서 프롬프트를 요청하고, 응답 텍스트를 받아 이미지 서비스에 붙여넣거나 전송하세요. 두 서비스는 서로 독립적으로 유지됩니다.
시도하려면 카드가 필요한가요?
아니요. 신규 사용자는 키 페이지에서 한 번의 클릭으로 7일 유효한 $0.50 무료 체험 크레딧을 청구할 수 있으며, 카드가 필요하지 않습니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 Base URL을 변경하세요. 설정은 이것으로 끝입니다.