貴数大規模モデル画像生成チュートリアル
画像生成 API、モデルの選択、パラメータ設定、呼び出し方法を分かりやすく説明します。
貴数大規模モデルの画像生成機能を提供開始しました。
WeChat 公式アカウントのカバー、商品紹介画像、アプリアイコン、商品画像、Agent による自動画像生成など、いずれも統一 API から直接生成できます。
画像生成 API:POST https://api.llm-token.cn/v1/images/generations
一、まずは結論:この 3 つを用意すれば使えます ✨
| 用意するもの | 入力方法 |
|---|---|
| 貴数 Token キー | リクエストヘッダーに Authorization: Bearer 你的new-api-token を入力します |
| 画像生成 API | https://api.llm-token.cn/v1/images/generations |
| 画像生成モデル | image-01 または image-01-live |
貴数大規模モデルでは、モデル連携、API 対応、クォータ管理、課金ルールがすでに統一されています。ご自身の貴数 Token キーを使用するだけで、1 つの API から画像生成機能を呼び出せます。
二、1 分で動作確認:curl の例 🚀
次の YOUR_NEW_API_TOKEN をご自身の貴数 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
}'初回のテストでは、まず 1 枚、つまり n: 1 で生成することをおすすめします。正常に生成できることを確認してから、必要に応じて比率、スタイル、枚数を調整してください。
三、リクエストパラメータの入力方法 🧩
| パラメータ | 必須 | よく使う値 | 説明 |
|---|---|---|---|
model | はい | image-01 | 画像生成モデル名です。よりリアルタイム性の高い画像生成機能が必要な場合は、image-01-live も指定できます。 |
prompt | はい | 画像の要件に応じて入力 | 生成したい画像を記述します。被写体、スタイル、色、構図、用途を明確に記述することをおすすめします。 |
response_format | いいえ | url | 画像リンクが直接返される url を推奨します。用途に応じて base64 も使用できます。 |
n | いいえ | 1 | 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 が返された場合は、生成後すぐに保存することをおすすめします。画像リンクは一時的なプレビューやダウンロードに適しており、素材の恒久的な配信元として使用することはおすすめしません。
四、貴数大規模モデルが使いやすい理由 🍬
一般的な連携では、複数のモデルプラットフォームを切り替えながら使用することが多く、キー、API、課金方法がそれぞれ異なるため、開発と保守が複雑になりがちです。
貴数大規模モデルでは、これらをすべて統一しています。 貴数 Token キーが 1 つあれば、統一 API から画像生成機能を呼び出せます。使用量、倍率、残高は貴数 Token の管理画面に表示される内容に基づくため、分かりやすく管理できます。
| 機能 | 説明 |
|---|---|
| 統一 API | 画像生成には共通で https://api.llm-token.cn/v1/images/generations を使用するため、連携がより簡単です。 |
| 統一キー | 貴数 Token の管理画面で生成した new-api-token を使用するため、複数のプラットフォームを切り替える必要がありません。 |
| 統一課金 | 使用量、倍率、残高はすべて貴数 Token の管理画面に表示される内容に基づくため、チームのコスト管理に便利です。 |
| ビジネス連携に最適 | WeChat 公式アカウント用画像、商品画像、製品カバー、Agent による自動画像生成、素材の一括生成などに適しています。 |
ひとことで言うと、貴数 Token なら 1 つの API で、画像生成機能を製品やワークフローに組み込めます。
五、image-01-live の使い方 ⚡
image-01-live でも同じ画像生成 API を使用します。他のパラメータは変更せず、model を image-01-live に変えるだけです。
{
"model": "image-01-live",
"prompt": "一张赛博风格的蓝色产品宣传图,干净背景,科技感,适合公众号封面",
"response_format": "url",
"n": 1,
"aspect_ratio": "16:9",
"prompt_optimizer": false
}アカウントでこのモデルが有効になっていれば、このまま呼び出せます。
六、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 秒程度に設定することをおすすめします。
七、効果的な画像を生成するための説明方法 🪄
画像の内容は、次の順序で記述すると、より安定した結果を得やすくなります。
- 被写体:描きたいものです。例:「青い AI ロボット」「ワールドカップ分析ポスター」。
- シーン:配置する場所です。例:「白い背景」「スタジアムの照明の下」「オフィスのデスク」。
- スタイル:ミニマル、写実、3D、イラスト、商用ポスター、写真のような質感などです。
- 構図:中央配置、俯瞰、上半身、余白、横長のカバーなどです。
- 色:メインカラーと補助色です。例:青と白、黒と金、赤と青のコントラスト。
- 制限:例:「文字を入れない」「透かしを入れない」「背景をすっきりさせる」。
次の簡単なテンプレートをそのまま使用できます。
一张【比例】的【用途】图片,主体是【主体】,场景是【场景】,整体风格为【风格】,主色为【颜色】,构图【构图要求】,细节要求【限制或补充】。例:
一张 1:1 的应用图标,主体是蓝色发光的 AI 芯片,白色背景,极简 3D 风格,居中构图,边缘清晰,不要文字。八、問題が発生したときの確認事項 🛟
| 現象 | 対処方法 |
|---|---|
| 認証失敗と表示される | リクエストヘッダーが Authorization: Bearer YOUR_NEW_API_TOKEN になっているか確認し、token の前後に余分なスペースがないことを確認します。 |
| モデルが存在しないと表示される | モデル名が image-01 または image-01-live と正確に入力されているか確認し、大文字と小文字を変更しないでください。 |
| 画像の比率が想定と異なる | まず aspect_ratio を調整します。一般的な WeChat 公式アカウントのカバーには 16:9、プロフィール画像やアイコンには 1:1 を使用できます。 |
| 画像リンクを開けない | 画像 URL の有効期限が切れている可能性があります。生成後すぐにダウンロードするか、ご自身の素材ライブラリへ保存することをおすすめします。 |
| リクエストの待機時間が長い | 画像生成自体に時間がかかります。リクエストのタイムアウトを 120 秒以上に設定することをおすすめします。 |
| 生成結果が安定しない | 要件を具体的に記述し、互いに矛盾する説明を減らしてください。類似した結果が必要な場合は seed を固定できます。 |
九、開発担当者へそのまま共有できる内容 📮
貴数大規模モデルの画像生成機能を使用します。API は 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 などのパラメータを渡します。
十、どのような用途に適しているか 📚
| 用途 | 活用方法 |
|---|---|
| WeChat 公式アカウント/RED 用画像 | カバー、メインビジュアル、イベントポスター、記事内画像をすばやく生成します。 |
| 製品と SaaS ページ | アプリアイコン、機能説明画像、Banner、空状態のイラストを生成します。 |
| EC と商品素材 | 商品の背景画像、販促画像、商品詳細ページのイメージ画像を生成します。 |
| Agent 自動化ワークフロー | コンテンツに応じて Agent に画像を自動生成させ、コンテンツ制作の効率を高めます。 |