Zhipu: CogView 4
CogView 4 là mô hình tạo ảnh từ văn bản của Zhipu, có trong Ailoot Ultra dưới ID chính xác cogview-4. Cung cấp mô tả cảnh để tạo ảnh minh họa, bối cảnh sản phẩm hoặc ý tưởng hình ảnh. Các tùy chọn được ghi trong tài liệu gồm kích thước ảnh, chất lượng standard hoặc hd và watermark_enabled; phản hồi cung cấp các URL ảnh cần được lưu đầy đủ.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
CogView 4 chuyển bản mô tả hình ảnh bằng văn bản thành các ảnh đầu ra. Chọn cogview-4 trong POST /v1/images/generations và cung cấp prompt dưới dạng chuỗi văn bản. Các đầu vào bắt buộc là model và prompt. Dùng bản mô tả để diễn đạt chủ thể chính, vị trí của chủ thể, cảnh xung quanh và cách thể hiện hình ảnh mà bạn muốn đánh giá.
Với bối cảnh sản phẩm, hãy mô tả vật thể, bề mặt bên dưới, phông nền và hướng ánh sáng. Với ảnh minh họa, hãy chỉ rõ nhân vật hoặc vật thể, cảm xúc dự định truyền tải và bố cục. Nếu ảnh sẽ nằm cạnh tiêu đề hoặc phần mô tả sản phẩm, hãy nêu vị trí cần để trống trong bố cục. Đánh giá kết quả theo những yêu cầu cụ thể đó trước khi đưa vào thiết kế.
Hướng dẫn kích thước riêng cho CogView liệt kê 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 và 720x1440. Hướng dẫn kích thước tùy chỉnh quy định mỗi cạnh trong khoảng 512 đến 2048 pixel, chia hết cho 16, với tổng số pixel không vượt quá 2^21. Chọn khung hình phù hợp với vị trí sử dụng: minh họa dọc, cảnh sản phẩm vuông và hình ảnh ngang rộng đòi hỏi bố cục khác nhau bên cạnh kích thước khác nhau.
quality chấp nhận standard hoặc hd, với standard được ghi là giá trị mặc định của CogView. watermark_enabled là boolean có giá trị mặc định được ghi trong tài liệu là true. Chuỗi user_id tùy chọn xác định người dùng cuối và phải chứa từ 6 đến 128 ký tự. Tách định danh đó khỏi lời nhắc sáng tạo. Khi thay đổi chất lượng hoặc kích thước, cần có mục đích sử dụng ảnh rõ ràng đi kèm, thay vì dùng các thay đổi đó để thay thế phần mô tả nội dung cần xuất hiện.
Quá trình tạo trả về phản hồi JSON đồng bộ chứa created và data. Mỗi mục data[] cung cấp một url. Tải mọi ảnh được trả về và lưu phản hồi cùng bản mô tả và các thiết lập đã chọn; đừng chỉ giữ mục đầu tiên chỉ vì bản xem trước hiển thị một ảnh. Hợp đồng được mô tả trong tài liệu không đưa ra bước thăm dò tác vụ riêng theo kiểu video cho yêu cầu ảnh này. Nếu phản hồi bị gián đoạn hoặc chưa đầy đủ, hãy giữ lại thông tin yêu cầu ban đầu và kết quả đã nhận trước khi quyết định có phù hợp để gửi yêu cầu tạo tiếp hay không. Ailoot lưu các ảnh này thành tài sản phương tiện thuộc sở hữu của bạn và trả về liên kết Ailoot có chữ ký. Tìm các bản ghi tài sản qua GET /v1/media/assets?family=image, tiếp tục theo mọi next_cursor. Đọc GET /v1/media/assets/{asset_id} với từng asset_id thực tế để lấy content_url của tài sản; đọc lại chính tài sản đó nếu liên kết có chữ ký hết hạn.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Bắt đầu
CogView 4 là mô hình tạo ảnh từ văn bản của Zhipu, có trong Ailoot Ultra dưới ID chính xác cogview-4. Cung cấp mô tả cảnh để tạo ảnh minh họa, bối cảnh sản phẩm hoặc ý tưởng hình ảnh. Các tùy chọn được ghi trong tài liệu gồm kích thước ảnh, chất lượng standard hoặc hd và watermark_enabled; phản hồi cung cấp các URL ảnh cần được lưu đầy đủ.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- Ảnh
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Images POST /v1/images/generations
- Đầu vào
text- Đầu ra
image- Định dạng đầu ra
- Tệp ảnh
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn cogview-4 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngsize | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Mặc định1280x1280 |
Trườnguser_id | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngquality | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn hd, standard | Mặc định— |
Trườngwatermark_enabled | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc địnhtrue |
Trườngstream | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false | Mặc định— |
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, prompt |
Tham sốoptional | Hợp đồngsize, user_id, quality, watermark_enabled, stream |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốconditions | Hợp đồngUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Bảng giá
Cách tính phí cuối cùng
Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí ước tính để so sánh
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Số lượng dự báo | Phí |
|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token |
| Cấu hìnhEstimated generation cost | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Phí Đầu vào · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.09 ước tính trước khi tạo This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "cogview-4", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Nhận và lưu kết quả
Ailoot Ultra · Images
Tải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lưu tất cả kết quả đã hoàn tất
Lưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Nếu cần kiểm tra phản hồi gốc
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Bí danh
Bí danh mô hình
Ailoot Ultra cogview-4
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · Zhipu: CogView 4
- Có những đầu vào và kết quả nào?
POST /v1/images/generations·cogview-4:text→image- Yêu cầu sử dụng những trường nào?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream