이미지 생성 인터페이스, 모델 선택, 매개변수 설정 및 호출 방법을 안내합니다.

Guishu 대규모 모델의 이미지 생성 기능이 출시되었습니다. 공식 계정 표지, 제품 이미지, 앱 아이콘, 상품 이미지부터 Agent 자동 이미지 생성까지 통합 인터페이스를 통해 바로 만들 수 있습니다. 이미지 생성 인터페이스: POST https://api.llm-token.cn/v1/images/generations

1. 먼저 확인: 3가지 항목만 준비하면 사용할 수 있습니다 ✨

준비 항목	입력 방법
Guishu Token 키	요청 헤더에 `Authorization: Bearer 你的new-api-token` 입력
이미지 생성 인터페이스	`https://api.llm-token.cn/v1/images/generations`
이미지 생성 모델	`image-01` 또는 `image-01-live`

Guishu 대규모 모델에서는 모델 연동, 인터페이스 어댑테이션, 잔액 관리 및 과금 규칙이 모두 통합되어 있습니다. 본인의 Guishu Token 키만 사용하면 하나의 인터페이스에서 이미지 생성 기능을 호출할 수 있습니다.

2. 1분 만에 실행: curl 예시 🚀

아래의 YOUR_NEW_API_TOKEN을 본인의 Guishu Token 키로 교체하면 바로 테스트할 수 있습니다.

curl https://api.llm-token.cn/v1/images/generations \
  -H "Authorization: Bearer YOUR_NEW_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "一张可爱的蓝色 AI 小机器人图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": false
  }'

첫 테스트에서는 n: 1로 이미지 1장만 생성하는 것이 좋습니다. 정상적으로 생성되는지 확인한 뒤 필요에 따라 비율, 스타일 및 수량을 조정하십시오.

3. 요청 매개변수 입력 방법 🧩

매개변수	필수	자주 사용하는 값	설명
`model`	예	`image-01`	이미지 생성 모델 이름입니다. 더 실시간에 가까운 이미지 생성 기능이 필요하면 `image-01-live`를 입력할 수도 있습니다.
`prompt`	예	이미지 요구 사항에 맞게 입력	생성할 이미지를 설명합니다. 주제, 스타일, 색상, 구도 및 용도를 명확히 작성하는 것이 좋습니다.
`response_format`	아니요	`url`	이미지 링크를 바로 반환하는 `url` 사용을 권장합니다. 비즈니스 요건에 따라 `base64`를 사용할 수도 있습니다.
`n`	아니요	`1`	한 번에 생성할 이미지 수입니다. 일반적인 테스트에서는 먼저 `1`을 입력하는 것이 좋습니다.
`aspect_ratio`	아니요	`1:1`	이미지 비율입니다. 자주 사용하는 값: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `21:9`.
`prompt_optimizer`	아니요	`false`	프롬프트 최적화 사용 여부입니다. 원문을 더 엄격하게 따르도록 생성하려면 `false`를 권장합니다.
`seed`	아니요	정수	재현성을 높이는 데 사용합니다. 비슷한 결과를 여러 번 생성하려면 같은 seed를 고정할 수 있습니다.
`width` / `height`	아니요	일반적으로 불필요	대부분의 경우 `aspect_ratio`만 사용하면 됩니다. 정확한 너비와 높이가 필요할 때만 전달하십시오.

이미지 URL이 반환되면 생성 후 즉시 저장하는 것이 좋습니다. 이미지 링크는 임시 미리보기와 다운로드에는 적합하지만 장기적인 자료 원본 주소로 사용하는 것은 권장하지 않습니다.

4. Guishu 대규모 모델이 더 간편한 이유 🍬

일반적인 연동에서는 서로 다른 키, 인터페이스 및 과금 방식을 사용하는 여러 모델 플랫폼 사이를 오가야 하므로 개발과 유지 관리가 번거로운 경우가 많습니다.

Guishu 대규모 모델은 이 모든 항목을 통합했습니다. 하나의 Guishu Token 키만 있으면 통합 인터페이스를 통해 이미지 생성 기능을 호출할 수 있습니다. 사용량, 배율 및 잔액은 Guishu Token 백엔드의 표시를 기준으로 명확하게 관리할 수 있습니다.

기능	설명
통합 인터페이스	이미지 생성에는 `https://api.llm-token.cn/v1/images/generations`를 통일하여 사용하므로 연동이 더 간단합니다.
통합 키	Guishu Token 백엔드에서 생성한 `new-api-token`을 사용하므로 여러 플랫폼 사이에서 전환할 필요가 없습니다.
통합 과금	사용량, 배율 및 잔액은 모두 Guishu Token 백엔드 표시를 기준으로 하여 팀 비용을 편리하게 관리할 수 있습니다.
비즈니스 통합에 적합	공식 계정 이미지, 상품 이미지, 제품 표지, Agent 자동 이미지 생성 및 대량 자료 생성 등의 시나리오에 적합합니다.

한 문장 요약: 하나의 Guishu Token과 하나의 인터페이스로 제품 및 워크플로에 이미지 생성 기능을 연동할 수 있습니다.

5. image-01-live 사용 방법 ⚡

image-01-live는 동일한 이미지 생성 인터페이스를 사용합니다. 다른 매개변수는 그대로 두고 model만 image-01-live로 변경하면 됩니다.

{
  "model": "image-01-live",
  "prompt": "一张赛博风格的蓝色产品宣传图，干净背景，科技感，适合公众号封面",
  "response_format": "url",
  "n": 1,
  "aspect_ratio": "16:9",
  "prompt_optimizer": false
}

계정에서 이 모델을 사용할 수 있다면 위와 같이 바로 호출할 수 있습니다.

6. Python 예시: 프로젝트에서 사용 🐍

import requests

url = "https://api.llm-token.cn/v1/images/generations"
headers = {
    "Authorization": "Bearer YOUR_NEW_API_TOKEN",
    "Content-Type": "application/json",
}
payload = {
    "model": "image-01",
    "prompt": "一张科技感很强的蓝色应用图标，白色背景，极简 3D 风格，居中构图，不要文字",
    "response_format": "url",
    "n": 1,
    "aspect_ratio": "1:1",
    "prompt_optimizer": False,
}

resp = requests.post(url, headers=headers, json=payload, timeout=120)
resp.raise_for_status()
print(resp.json())

이미지 생성은 일반 텍스트 대화보다 시간이 더 걸립니다. 이미지 생성이 완료되기 전에 클라이언트가 요청을 중단하지 않도록 클라이언트 시간 제한을 약 120초로 설정하는 것이 좋습니다.

7. 더 좋은 이미지를 생성하는 설명 방법 🪄

이미지를 설명할 때 다음 순서로 작성하면 더 안정적인 결과를 얻을 수 있습니다.

주제: 그리고 싶은 대상. 예: ‘파란색 AI 로봇’, ‘월드컵 분석 포스터’.
장면: 대상이 놓일 장소. 예: ‘흰색 배경’, ‘경기장 조명 아래’, ‘사무실 책상’.
스타일: 미니멀, 사실적, 3D, 일러스트, 상업용 포스터, 사진 질감 등.
구도: 중앙 배치, 위에서 내려다보기, 상반신, 여백, 가로형 표지 등.
색상: 기본색과 보조색. 예: 파란색과 흰색, 검은색과 금색, 빨간색과 파란색의 대비.
제한 사항: ‘텍스트 제외’, ‘워터마크 제외’, ‘깔끔한 배경’ 등.

다음의 간단한 템플릿을 그대로 사용할 수 있습니다.

一张【比例】的【用途】图片，主体是【主体】，场景是【场景】，整体风格为【风格】，主色为【颜色】，构图【构图要求】，细节要求【限制或补充】。

예시:

一张 1:1 的应用图标，主体是蓝色发光的 AI 芯片，白色背景，极简 3D 风格，居中构图，边缘清晰，不要文字。

8. 문제 해결 🛟

현상	처리 방법
인증 실패 표시	요청 헤더가 `Authorization: Bearer YOUR_NEW_API_TOKEN` 형식인지 확인하고 token을 복사할 때 불필요한 공백이 포함되지 않았는지 확인하십시오.
모델이 존재하지 않는다는 메시지	모델 이름을 `image-01` 또는 `image-01-live`로 정확히 입력했는지 확인하고 대소문자를 변경하지 마십시오.
이미지 비율이 예상과 다름	먼저 `aspect_ratio`를 조정하십시오. 일반적인 공식 계정 표지에는 `16:9`, 프로필 이미지 또는 아이콘에는 `1:1`을 사용할 수 있습니다.
이미지 링크를 열 수 없음	이미지 URL이 만료되었을 수 있습니다. 생성 후 즉시 다운로드하거나 자체 자료실로 옮겨 저장하는 것이 좋습니다.
요청 대기 시간이 김	이미지 생성 자체에 시간이 필요하므로 요청 시간 제한을 120초 이상으로 설정하는 것이 좋습니다.
생성 결과가 충분히 안정적이지 않음	요구 사항을 더 구체적으로 작성하고 서로 충돌하는 설명을 줄이십시오. 비슷한 결과가 필요하면 `seed`를 고정할 수 있습니다.

9. 개발자에게 바로 전달할 수 있는 설명 📮

Guishu 대규모 모델을 통해 이미지 생성 기능을 호출합니다. 인터페이스는 POST https://api.llm-token.cn/v1/images/generations입니다. 요청 헤더에는 Authorization: Bearer YOUR_NEW_API_TOKEN을 사용하고, 요청 본문에 model: image-01 또는 model: image-01-live를 입력한 뒤 prompt, response_format: url, n, aspect_ratio 등의 매개변수를 전달하면 됩니다.

10. 적용 시나리오 📚

시나리오	활용 방법
공식 계정 / Xiaohongshu 이미지	표지, 헤더 이미지, 이벤트 포스터 및 글 삽화를 빠르게 생성합니다.
제품 및 SaaS 페이지	앱 아이콘, 기능 이미지, Banner 및 빈 상태 일러스트를 생성합니다.
전자상거래 및 상품 자료	상품 배경 이미지, 프로모션 이미지 및 상세 페이지 분위기 이미지를 생성합니다.
Agent 자동화 워크플로	Agent가 콘텐츠에 따라 이미지를 자동으로 생성하도록 하여 콘텐츠 제작 효율을 높입니다.

Your privacy choices

Guishu 대규모 모델 이미지 생성 가이드