Flux 프롬프트용 LLM API: 실용적인 워크플로우
Flux 프롬프트용 LLM API를 사용하려면 작업이 간단합니다. 텍스트 모델에 짧은 아이디어를 보내고 이미지 서비스에서 사용할 수 있는 상세한 프롬프트를 받습니다. 이 페이지에서는 시스템 프롬프트, 설정 및 코드를 보여주고 텍스트 전용 모델이 할 수 없는 일을 명확히 설명합니다.
업데이트됨

주요 포인트
- 시스템 메시지로 형식과 스타일을 한 번에 고정한 후, 요청당 짧은 아이디어만 전송하세요.
- JSON 모드는 스크립트가 일반 텍스트를 파싱하지 않고 반복할 수 있는 프롬프트 변형 목록을 반환합니다.
- 100,000토큰 컨텍스트 창을 사용해 스타일 가이드나 이전 프롬프트를 요청에 붙여넣을 수 있습니다.
- 프롬프트 한 번을 완전히 확장하는 데는 1센트도 채 안 되는 비용이 들며, 모델은 이미지를 보거나 생성하지 않습니다.
간단 요약
API 키를 생성하고 OpenAI 클라이언트를 https://api.fluxapikey.com/v1로 설정한 후, 모델을 uncensored로 지정합니다. 그런 다음 시스템 메시지에 프롬프트 규칙을 입력합니다. 각 사용자 메시지는 아이디어만 포함됩니다. 짧은 단어, 장면, 캐릭터 등입니다. 완성된 프롬프트를 복사하여 사용하는 이미지 도구에 붙여넣습니다. 각 도구에는 자체 키와 자체 요금 정산 시스템이 있습니다.
여기서는 이미지를 생성하지 않습니다. API는 텍스트 전용이며 이미지 벤더의 서비스가 아니며 렌더링을 볼 수 없습니다. 잘하는 것은 글쓰기입니다: 구조, 어휘, 배치 전체의 일관성. 이 페이지의 나머지 부분은 실용적인 세부 사항입니다.
왜 프롬프트에 언어 모델을 사용해야 하나요
이미지 모델은 구체적인 입력을 보상하고 모호한 입력을 처벌합니다. "성"이라는 문장은 평균적인 성을 생성합니다. 벽의 재질, 시간대, 렌즈 및 색상 팔레트를 명시하는 단락은 머릿속의 이미지에 더 가까운 결과를 줍니다. 모든 이미지에 대해 이 단락을 직접 작성하는 것은 느리며, 매번 같은 세부 사항을 잊게 됩니다.
언어 모델은 이러한 확장 작업에 매우 뛰어납니다. 누락된 세부 정보를 추가하고, 요소의 고정 순서를 유지하며, 수백 개의 요청에 걸쳐 일관된 스타일을 유지합니다. 이 모델은 기본적으로 거절하지 않으므로, 더 신중한 호스팅 모델이 종종 거부하는 성인 대상 픽션, 어두운 주제, 캐릭터 작업도 처리할 수 있습니다. 일반적인 제한이 적용됩니다: 합법적인 성인 사용만 가능하며, 어떤 형태로도 미성년자가 포함된 성 콘텐츠는 허용되지 않습니다.
효과적인 시스템 프롬프트
품질의 대부분은 시스템 메시지에서 나옵니다. 짧고 구체적이며 테스트 가능하게 유지하세요. 다음은 편집할 수 있는 시작점입니다:
SYSTEM = '''You write prompts for a text-to-image model.
Output exactly one prompt, one paragraph, no preamble, no quotes.
Order: subject, action, setting, lighting, camera or medium, palette, mood.
Use concrete nouns and visual adjectives. Avoid abstract words like beautiful.
Do not mention the words prompt, image or render.
Keep it under 90 words.'''
메시지가 무엇을 말하지 않는지 주목하세요. 창의성에 대한 긴 강연이나 금지된 주제 목록을 제공하지 않습니다. 짧은 규칙과 고정된 순서는 모델이 따르기 쉽고 디버깅하기 쉽습니다. 출력이 어긋나면 한 줄을 변경하고 같은 아이디어를 다시 실행합니다. 다른 프로젝트에 다른 하우스 스타일이 필요하면 두 번째 시스템 메시지를 유지하고 요청당 하나를 선택합니다.
설명하지 말고 보여주세요
규칙만으로는 부족할 때, 대화의 이전 메시지로 한두 쌍의 예제를 추가하세요: 사용자 메시지로 짧은 아이디어와 어시스턴트 메시지로 선호하는 프롬프트를 제공합니다. 한두 쌍은 규칙 단락을 하나 더 추가하는 것보다 어조를 더 잘 고정합니다.
요청 전송
호출은 표준 채팅 완료입니다. 창의적 확장에 가장 중요한 설정은 temperature와 seed입니다.
from openai import OpenAI
client = OpenAI(base_url="https://api.fluxapikey.com/v1", api_key="YOUR_KEY")
def expand(idea, seed=None):
r = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": SYSTEM},
{"role": "user", "content": idea},
],
temperature=0.9,
top_p=0.95,
max_tokens=200,
seed=seed,
)
return r.choices[0].message.content.strip()
print(expand("an abandoned observatory on a cliff", seed=7))
0.8에서 1.0 사이의 temperature는 아이디어 브레인스토밍 시 원하는 다양한 어휘를 제공합니다. 반복된 템플릿에 대해 거의 동일한 출력이 필요할 때 0.3 근처로 낮춥니다. seed, top_p, stop 및 패널티 매개변수는 모델에 전달되므로 다른 곳에서 사용하는 것처럼 사용할 수 있습니다. max_tokens 제한은 선택 사항입니다; 예상 길이에 가깝게 설정하면 응답이 길어지는 것을 방지합니다. 지원되는 모든 매개변수에 대해서는 문서를 참조하세요.
JSON 모드를 사용한 변형 배치
배치의 경우 목록을 요청하고 response_format으로 JSON 모드를 켭니다. JSON 모드는 출력을 유효한 JSON으로 만들지만 키를 선택하지 않으므로 시스템 메시지는 여전히 모델이 반환할 형식을 알려야 합니다.
# client as above: base_url https://api.fluxapikey.com/v1
import json
def variations(idea, n=8):
r = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
messages=[
{"role": "system", "content": SYSTEM + f"\nReturn JSON: {{\"prompts\": [{n} strings]}}."},
{"role": "user", "content": idea},
],
temperature=1.0,
)
return json.loads(r.choices[0].message.content)["prompts"]
for p in variations("a night market in the rain"):
print(p)
json.loads를 try 블록으로 감싸세요. 응답이 매우 낮은 max_tokens로 인해 잘리면 구문 분석이 실패하므로, 목록 요청에는 해당 매개변수를 넉넉하게 설정하세요. 목록의 각 프롬프트는 루프를 통해 이미지 서비스에 직접 전달할 수 있습니다.
100,000개 토큰 창 사용
컨텍스트 창은 프롬프트와 완성 토큰을 포함하여 100,000 토큰입니다. 프롬프트 작업에는 요청당 필요량보다 훨씬 많지만, 두 가지 방법으로 유용합니다. 긴 스타일 가이드, 캐릭터 시트, 또는 이전에 작동한 프롬프트 목록을 붙여넣으면 모델이 이를 따릅니다. 또한 대화식 작업을 계속할 수 있습니다: 프롬프트를 요청하고 "더 어둡게, 안개를 추가해"라고 하면 첫 번째 내용을 기억하며 수정된 프롬프트를 받을 수 있습니다.
긴 입력은 비용이 발생하므로 상시 스타일 가이드는 출력을 바꾸는 내용으로만 한정하세요. 500토큰의 규칙은 저렴합니다. 매 요청마다 보내는 50,000토큰의 이전 프롬프트는 합산됩니다. 아래 비용 섹션에서 알 수 있듯이: 50,000 추가 입력 토큰은 요청당 $0.0075이며, 500회 요청 시 $3.75입니다.
일반 작업용 프롬프트 패턴
같은 엔드포인트가 여러 다른 작업을 처리합니다. 변경되는 것은 시스템 메시지입니다.
- 캐릭터 시트. 시스템 메시지에 반복되는 캐릭터의 고정 설명(머리카락, 의상, 나이, 체격)을 유지하고, 모델이 모든 프롬프트에서 이를 단어 그대로 반복하도록 지시합니다. 이것이 일련의 렌더링 전반에서 캐릭터를 인식 가능하게 유지하는 가장 저렴한 방법입니다.
- 단어로 스타일 전송. "구아슈, 차분한 팔레트, 입자감"와 같은 선호하는 스타일 용어 목록을 제공하고 모든 프롬프트의 마지막 문장에 이를 요청하세요.
- 네거티브 표현. 이미지 도구가 별도의 부정 프롬프트를 받는 경우, JSON 모드에서
prompt과negative두 필드를 반환하도록 모델에게 요청하세요. 부정 목록은 짧고 구체적으로 유지하세요. - 단축. 일부 도구는 긴 입력을 잘라냅니다. 규칙에 단어 제한을 추가하고 테스트하세요. 모델은 단어를 대략적으로 세므로 필요합니다.
성인용 픽션 및 롤플레이 아트도 여기서 합당한 사례입니다. 모델은 요청 시 평범하고 노골적이지 않은 표현로 장면 설명을 작성합니다. 콘텐츠 규칙이 자체적으로 있는 플랫폼에서 작업하는 경우, 그 규칙을 시스템 메시지에 입력하여 프롬프트가 이미지가 게시될 곳과 일치하도록 하세요.
루프 테스트 및 조정
시스템 메시지를 코드처럼 취급하세요. 일반적인 범위를 커버하는 5개의 테스트 아이디어를 선택하고, 고정된 seed과 낮은 temperature로 실행한 후 출력을 저장합니다. 규칙을 변경할 때마다 동일한 5개를 다시 실행하고 비교하세요. 이는 한 사례에 대한 수정이 다른 사례를 깨뜨리는 일반적인 실패를 포착합니다.
세 가지 증상을 확인하세요. 배치 전체에서 같은 시작 단어를 반복하는 프롬프트는 temperature가 너무 낮거나 예제가 너무 균일함을 의미합니다. 단어 제한을 무시하는 프롬프트는 규칙이 묻혀 있다는 뜻이므로 메시지를 마지막으로 옮기세요. "다음은 요청하신 프롬프트입니다" 같은 수다스러운 서두를 포함하는 프롬프트는 형식 규칙이 더 엄격해야 함을 의미하며, 코드에서 첫 줄을 제거할 수도 있습니다. UI에서 결과를 표시할 경우 stream: true 스트리밍을 사용할 수 있으며, 스트림 종료 시 사용량이 보고됩니다.
계획 수립을 위한 제한 사항
세 가지 정직한 제한 사항. 첫째, 모델은 텍스트 전용입니다: 이미지를 볼 수 없으므로 프롬프트가 좋은 그림을 생성했는지 판단할 수 없습니다. 판단은 사용자의 몫이며, 루프는 규칙을 작성하고 렌더링하고 조정하는 과정입니다. 둘째, 특정 이미지 모델의 특이사항을 알려주지 않으면 모델은 그 사실을 알 수 없으므로 시스템 메시지에 해당 특이사항을 명시하세요. 셋째, 속도 제한: 전체 키는 동시 요청 8개와 분당 300개를 허용하며, 체험 키는 동시 2개와 분당 60개를 허용합니다. 루프가 이 한도를 초과하면 코드 concurrency 또는 rate_limited와 함께 HTTP 429 오류가 발생하므로 잠시 후 다시 시도하세요. Retry-After: 5 헤더가 포함된 429 오류는 일시적 과부하를 의미하며 동일한 조언이 적용됩니다.
프롬프트별 비용
가격은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 각 요청이 800토큰의 시스템 메시지와 아이디어를 보내고 200토큰의 프롬프트를 반환한다고 가정합니다. 500회 요청 동안 이는 400,000 입력 토큰과 100,000 출력 토큰입니다. 입력: 0.4 x $0.15 = $0.06. 출력: 0.1 x $0.50 = $0.05. 총계: 500개 프롬프트에 $0.11.
위의 JSON 배치는 호출당 약 400 입력 토큰과 700 출력 토큰으로, 0.0004 x $0.15 + 0.0007 x $0.50의 비용이 들며, 이는 8개 프롬프트에 대해 $0.00006 + $0.00035 = $0.00041입니다. 체험 크레딧은 $0.50이며, 가입 후 한 번의 클릭으로 받을 수 있습니다. 충전은 $20부터 시작합니다. 보너스 티어는 요금 페이지을 참조하고, 시작하려면 키 페이지로 이동하세요.
더 많은 가이드
질문과 답변
모델은 모든 이미지 생성기용 프롬프트를 작성할 수 있나요?
네, 텍스트만 생성하기 때문입니다. 시스템 메시지에서 이미지 도구가 선호하는 형식을 알려준 후 결과를 복사하여 사용하면 됩니다.
성인 또는 어두운 주제를 거부하나요?
합법적인 성인 사용을 위해 콘텐츠 거부 없이 답변하도록 조정되었습니다. 미성년자가 관련된 성 콘텐츠는 절대 허용되지 않습니다.
분당 몇 개의 프롬프트를 생성할 수 있나요?
전체 키는 분당 300개의 요청과 동시에 8개의 요청을 허용합니다. JSON 모드에서는 하나의 요청으로 여러 프롬프트를 반환할 수 있습니다.
이미지도 함께 생성하나요?
아니요. API는 텍스트 전용이며 이미지, 오디오 또는 비디오 생성 기능이 없습니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.