OpenAI: DALL·E 3
DALL·E 3 tạo ảnh từ bản mô tả cảnh bằng văn bản. Dùng ID mô hình chính xác openai/dall-e-3 hoặc bí danh dall-e-3 với phương thức tạo ảnh, rồi lưu mọi URL ảnh được trả về và kết quả đi kèm. Yêu cầu khởi đầu được ghi trong tài liệu tạo một ảnh 1024x1024 từ văn bản.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
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.
DALL·E 3 là mô hình tạo ảnh từ văn bản của OpenAI. Dùng bản mô tả bằng văn bản để tạo minh họa, ý tưởng cảnh hoặc định hướng hình ảnh cho thiết kế. Mô tả chủ thể, môi trường, bố cục, ánh sáng và cách thể hiện trong lời nhắc. Ví dụ, bản mô tả ý tưởng có thể yêu cầu xe đạp giao hàng bên cạnh cửa hàng nhỏ lúc chạng vạng, nhìn từ đường phố, có chủ thể tiền cảnh rõ ràng và bảng màu tiết chế.
Gửi POST /v1/images/generations với phần thân application/json. ID mô hình công khai chính xác là openai/dall-e-3; bí danh được chấp nhận dall-e-3 chọn cùng thẻ mô hình. Cấu trúc khởi đầu được ghi trong tài liệu cung cấp model, prompt, n:1 và size:"1024x1024". n là số nguyên tùy chọn và mặc định là 1. Gửi stream:false hoặc bỏ qua stream để nhận kết quả JSON đầy đủ. Dùng prompt văn bản không rỗng và giữ yêu cầu tập trung vào một bản mô tả ảnh hoàn chỉnh. Phương thức được cung cấp là tạo ảnh từ văn bản.
Nêu rõ các yêu cầu quan trọng đối với vị trí sử dụng. Minh họa biên tập có thể nêu ý tưởng trung tâm và các vật thể thể hiện ý tưởng đó. Ý tưởng cảnh có thể chỉ rõ vị trí máy quay, thời điểm trong ngày và những phần bố cục cần khoảng trống xung quanh. Tách câu chữ chính xác phải xuất hiện trong ảnh khỏi mô tả cảnh, rồi kiểm tra chữ được kết xuất và cách sắp xếp hình ảnh trước khi dùng kết quả đã chọn.
Phản hồi tạo ảnh là JSON với dấu thời gian created và mảng data. Mục kết quả được ghi trong tài liệu gồm url và có thể gồm revised_prompt, prompt_filter_results và content_filter_results. Giữ những trường đó cùng toàn bộ phản hồi và tải ảnh tại mọi URL Ailoot có chữ ký được trả về. Liên kết tệp Ailoot có chữ ký có hiệu lực 24 giờ từ lúc cấp. Giữ đúng URL được trả về, gồm chuỗi truy vấn, cho đến khi tệp được lưu; xác định định dạng ảnh đã lưu từ phản hồi thực tế hoặc các byte tệp.
Coi tệp ảnh được trả về là tài sản thiết kế có thể dùng và JSON là bản ghi tạo ảnh đi kèm. Đánh giá ảnh theo bản mô tả được cung cấp trước khi đưa vào trang, bài trình bày hoặc ứng dụng. Nếu phản hồi chưa đầy đủ hoặc kết quả gửi chưa chắc chắn, giữ định danh yêu cầu ban đầu và thông tin được trả về trong khi kiểm tra lần thử hiện có, thay vì tạo ảnh khác chỉ để khôi phục kết quả bị thiếu. Để lấy kết quả đã lưu, dùng cùng khóa API để GET /v1/media/assets?family=image và tiếp tục theo mọi next_cursor. ID tài sản xuất hiện trong mỗi URL /v1/media/assets/{asset_id}/content được trả về và trong bản ghi thư viện phương tiện của nó. Đọc GET /v1/media/assets/{asset_id} cho từng bản ghi đã chọn và tải đúng content_url của tài sản. Nếu yêu cầu tệp trả về 404 với mã link_expired, đọc lại chính tài sản đó để nhận liên kết được làm mới. Làm mới liên kết tài sản không cần yêu cầu tạo ảnh khác.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Bắt đầu
DALL·E 3 tạo ảnh từ bản mô tả cảnh bằng văn bản. Dùng ID mô hình chính xác openai/dall-e-3 hoặc bí danh dall-e-3 với phương thức tạo ảnh, rồi lưu mọi URL ảnh được trả về và kết quả đi kèm. Yêu cầu khởi đầu được ghi trong tài liệu tạo một ảnh 1024x1024 từ văn bản.
- Đầ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 openai/dall-e-3 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngstream | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false | Mặc địnhfalse |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1 | Mặc định— |
Trườngsize | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1024x1024 | 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 đồngstream, n, size |
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.32768 ướ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": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
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 openai/dall-e-3, dall-e-3
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
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Bắt đầu
DALL·E 3 tạo ảnh từ bản mô tả cảnh bằng văn bản. Dùng ID mô hình chính xác openai/dall-e-3 hoặc bí danh dall-e-3 với phương thức tạo ảnh, rồi lưu mọi URL ảnh được trả về và kết quả đi kèm. Yêu cầu khởi đầu được ghi trong tài liệu tạo một ảnh 1024x1024 từ văn bản.
- Đầ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 dall-e-3 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngstream | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false | Mặc địnhfalse |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1 | Mặc định— |
Trườngsize | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1024x1024 | 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 đồngstream, n, size |
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.32768 ướ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": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
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 openai/dall-e-3, dall-e-3
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 · OpenAI: DALL·E 3
- Có những đầu vào và kết quả nào?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Yêu cầu sử dụng những trường nào?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size