Giải thích rõ giao diện tạo ảnh, cách chọn mô hình, thiết lập tham số và phương thức gọi.

Khả năng tạo ảnh của mô hình lớn Guishu đã được ra mắt. Dù là ảnh bìa cho tài khoản công khai, ảnh minh họa sản phẩm, biểu tượng ứng dụng, ảnh hàng hóa hay Agent tự động gắn ảnh minh họa, tất cả đều có thể được tạo trực tiếp qua một giao diện thống nhất. Giao diện tạo ảnh: POST https://api.llm-token.cn/v1/images/generations

I. Xem kết luận trước: chuẩn bị 3 thứ này là dùng được ✨

Những gì bạn cần chuẩn bị	Cách điền
Khóa Token Guishu	Điền `Authorization: Bearer 你的new-api-token` trong header của yêu cầu
Giao diện tạo ảnh	`https://api.llm-token.cn/v1/images/generations`
Mô hình tạo ảnh	`image-01` hoặc `image-01-live`

Mô hình lớn Guishu đã thống nhất sẵn việc tích hợp mô hình, tương thích giao diện, quản lý hạn mức và quy tắc tính phí. Bạn chỉ cần dùng khóa Token Guishu của mình là có thể gọi khả năng tạo ảnh trong một giao diện duy nhất.

II. Chạy thử trong 1 phút: ví dụ curl 🚀

Thay YOUR_NEW_API_TOKEN bên dưới bằng khóa Token Guishu của riêng bạn là có thể kiểm tra trực tiếp.

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
  }'

Khi kiểm tra lần đầu, nên tạo trước 1 ảnh, tức là n: 1. Sau khi xác nhận có thể tạo ảnh bình thường, bạn mới tiếp tục điều chỉnh tỷ lệ, phong cách và số lượng theo nhu cầu.

III. Điền tham số yêu cầu như thế nào? 🧩

Tham số	Bắt buộc	Giá trị thường dùng	Giải thích
`model`	Có	`image-01`	Tên mô hình tạo ảnh. Nếu cần khả năng tạo ảnh theo thời gian thực hơn, cũng có thể điền `image-01-live`.
`prompt`	Có	Điền theo nhu cầu hình ảnh	Mô tả hình ảnh bạn muốn tạo. Nên viết rõ chủ thể, phong cách, màu sắc, bố cục và mục đích sử dụng.
`response_format`	Không	`url`	Khuyến nghị dùng `url` để trả trực tiếp liên kết ảnh; cũng có thể dùng `base64` theo nhu cầu nghiệp vụ.
`n`	Không	`1`	Số ảnh tạo trong một lần. Kiểm tra thông thường nên điền `1` trước.
`aspect_ratio`	Không	`1:1`	Tỷ lệ ảnh. Thường dùng: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `21:9`.
`prompt_optimizer`	Không	`false`	Có bật tối ưu prompt hay không. Nếu muốn ảnh bám sát nội dung gốc hơn thì nên điền `false`.
`seed`	Không	Số nguyên	Dùng để tăng khả năng tái hiện. Nếu muốn nhiều lần tạo ra hiệu quả gần giống nhau, có thể cố định cùng một seed.
`width` / `height`	Không	Thường không cần	Đa số trường hợp chỉ cần `aspect_ratio`; chỉ truyền khi thật sự cần chiều rộng và chiều cao chính xác.

Nếu kết quả trả về là URL ảnh, bạn nên lưu ảnh kịp thời sau khi tạo. Liên kết ảnh phù hợp để xem trước tạm thời và tải xuống, không nên dùng lâu dài làm địa chỉ nguồn tài nguyên.

IV. Vì sao dùng mô hình lớn Guishu sẽ nhàn hơn? 🍬

Kết nối theo cách thông thường thường phải chuyển qua lại giữa nhiều nền tảng mô hình: khóa khác nhau, giao diện khác nhau, cách tính phí khác nhau, nên cả phát triển lẫn bảo trì đều khá phiền.

Mô hình lớn Guishu đã thống nhất tất cả những phần này. Bạn chỉ cần một khóa Token Guishu là có thể gọi khả năng tạo ảnh thông qua giao diện thống nhất; mức sử dụng, hệ số và số dư cũng đều căn cứ theo phần hiển thị trong trang quản trị Guishu Token, rõ ràng và dễ quản lý.

Năng lực	Giải thích
Giao diện thống nhất	Tạo ảnh đều dùng `https://api.llm-token.cn/v1/images/generations`, việc tích hợp đơn giản hơn.
Khóa thống nhất	Dùng `new-api-token` được tạo trong trang quản trị Guishu Token, không cần chuyển đổi giữa nhiều nền tảng.
Tính phí thống nhất	Mức dùng, hệ số và số dư đều lấy phần hiển thị trong trang quản trị Guishu Token làm chuẩn, thuận tiện cho đội nhóm quản lý chi phí.
Phù hợp tích hợp nghiệp vụ	Phù hợp cho ảnh minh họa tài khoản công khai, ảnh hàng hóa, ảnh bìa sản phẩm, Agent tự động gắn ảnh, sinh tài nguyên hàng loạt và các tình huống khác.

Tóm lại trong một câu: dùng Guishu Token, một giao diện, đưa khả năng tạo ảnh vào sản phẩm và workflow của bạn.

V. Dùng image-01-live như thế nào? ⚡

image-01-live dùng cùng một giao diện tạo ảnh. Các tham số khác không đổi, chỉ cần đổi model thành image-01-live.

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

Nếu tài khoản của bạn đã được mở mô hình này, bạn có thể gọi trực tiếp theo cách đó.

VI. Ví dụ Python: đưa vào dự án để dùng 🐍

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())

Tạo ảnh mất thời gian hơn hội thoại văn bản thông thường, nên đặt thời gian chờ của client khoảng 120 giây để tránh việc ảnh chưa tạo xong mà yêu cầu đã bị client ngắt sớm.

VII. Mô tả ảnh như thế nào để dễ ra đúng ý hơn? 🪄

Khi mô tả ảnh, bạn có thể viết theo thứ tự này để kết quả ổn định hơn:

Chủ thể: bạn muốn vẽ gì, ví dụ “robot AI màu xanh” hoặc “poster phân tích World Cup”.
Bối cảnh: đặt ở đâu, ví dụ “nền trắng”, “dưới ánh đèn sân vận động”, “mặt bàn văn phòng”.
Phong cách: tối giản, chân thực, 3D, minh họa, poster thương mại, cảm giác nhiếp ảnh, v.v.
Bố cục: căn giữa, góc nhìn từ trên xuống, bán thân, chừa khoảng trắng, bìa ngang, v.v.
Màu sắc: màu chủ đạo và màu phụ, ví dụ xanh trắng, đen vàng, tương phản đỏ xanh.
Giới hạn: ví dụ “không có chữ”, “không watermark”, “nền sạch”.

Bạn có thể dùng trực tiếp mẫu nhỏ này:

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

Ví dụ:

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

VIII. Gặp vấn đề thì xem ở đây trước 🛟

Hiện tượng	Cách xử lý
Báo lỗi xác thực	Kiểm tra xem header đã viết đúng `Authorization: Bearer YOUR_NEW_API_TOKEN` hay chưa, đồng thời xác nhận token không bị sao chép kèm khoảng trắng thừa.
Báo mô hình không tồn tại	Kiểm tra tên mô hình đã được điền chính xác là `image-01` hoặc `image-01-live` chưa, không được đổi chữ hoa chữ thường.
Tỷ lệ ảnh không đúng như mong muốn	Ưu tiên điều chỉnh `aspect_ratio`. Ảnh bìa tài khoản công khai thường dùng `16:9`, ảnh đại diện hoặc biểu tượng có thể dùng `1:1`.
Không mở được liên kết ảnh	URL ảnh có thể đã hết hạn. Nên tải về ngay sau khi tạo hoặc chuyển vào kho tài nguyên của riêng bạn.
Thời gian chờ yêu cầu quá lâu	Bản thân quá trình tạo ảnh cần thời gian, nên đặt thời gian chờ của yêu cầu trên 120 giây.
Hiệu quả tạo ảnh chưa ổn định	Hãy viết yêu cầu cụ thể hơn, giảm các mô tả mâu thuẫn với nhau; nếu cần hiệu quả gần giống nhau thì có thể cố định `seed`.

IX. Phiên bản có thể gửi thẳng cho đồng nghiệp phát triển 📮

Chúng tôi gọi khả năng tạo ảnh thông qua mô hình lớn Guishu, giao diện là POST https://api.llm-token.cn/v1/images/generations. Header của yêu cầu dùng Authorization: Bearer YOUR_NEW_API_TOKEN, trong body chỉ cần điền model: image-01 hoặc model: image-01-live, đồng thời truyền các tham số như prompt, response_format: url, n, aspect_ratio là được.

X. Phù hợp với những tình huống nào? 📚

Tình huống	Có thể dùng như thế nào
Ảnh minh họa cho tài khoản công khai / Xiaohongshu	Nhanh chóng tạo ảnh bìa, ảnh đầu bài, poster sự kiện và hình minh họa bài viết.
Trang sản phẩm và SaaS	Tạo biểu tượng ứng dụng, ảnh minh họa tính năng, Banner, tranh minh họa trạng thái trống.
Thương mại điện tử và tài nguyên hàng hóa	Tạo ảnh nền sản phẩm, ảnh khuyến mãi, ảnh không khí cho trang chi tiết.
Workflow tự động hóa Agent	Cho phép agent tự động tạo ảnh minh họa theo nội dung, nâng cao hiệu suất sản xuất nội dung.

Your privacy choices

Hướng dẫn tạo ảnh với mô hình lớn Guishu