Source: https://ailoot.ai/docs/vi/api/images/ Canonical: https://ailoot.ai/docs/vi/api/images/ Language: vi [API](https://ailoot.ai/docs/vi/) # Images [Markdown](https://ailoot.ai/docs/vi/api/images/index.md) Tạo và chỉnh sửa ảnh theo định dạng OpenAI Images. POST`https://api.ailoot.ai/v1/images/generations` Images ```bash curl https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2.5", "prompt": "Tranh màu nước: ngọn hải đăng trên vách đá, lúc bình minh", "size": "1024x1024" }' ``` ```python img = client.images.generate( model="gpt-image-2.5", prompt="Tranh màu nước: ngọn hải đăng trên vách đá, lúc bình minh", size="1024x1024", ) print(img.data[0].url or "base64:", (img.data[0].b64_json or "")[:40]) ``` 200 OK ```json { "created": 1790812800, "data": [ { "url": "https://…/content" } ], "usage": { "input_tokens": 18, "output_tokens": 1056 } } ``` ## Xác thực | Tham số | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `Authorization` | header | bắt buộc | Khóa có dạng `Bearer sk-…`. Cũng có thể dùng các header `x-api-key` hoặc `x-goog-api-key`. | ## Phần thân yêu cầu | Tham số | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `model` | string | bắt buộc | Mô hình tạo ảnh: `gpt-image-2.5-sunburst`, `gemini-3.1-flash-image`, `grok-imagine-image-2.0`, `qwen-image-3.0-pro`, `image-01`, `gpt-image-2`, `gemini-3.1-flash-lite-image`, `grok-imagine-image`, `wan2.7-image`, `gpt-image-2.5-sunburst-2026-09-08`, `gemini-3-pro-image`, `grok-imagine-image-quality` và thêm [4](https://ailoot.ai/models/vi/?format=images). | | `prompt` | string | bắt buộc | Mô tả ảnh. | | `n` | integer | không bắt buộc | Số ảnh cần tạo. Mỗi ảnh hoàn thành đều được tính phí. | | `size` | string | không bắt buộc | Kích thước, ví dụ `1024x1024`. Kích thước được phép phụ thuộc vào mô hình. | | `quality` | string | không bắt buộc | Chất lượng, nếu mô hình hỗ trợ (ví dụ, `low`, `medium`, `high`). | | `response_format` | string | không bắt buộc | `url` hoặc `b64_json` — nếu mô hình hỗ trợ lựa chọn. | ## Chỉnh sửa POST`https://api.ailoot.ai/v1/images/edits` Yêu cầu `multipart/form-data`: trường `image` (một hoặc nhiều ảnh), `prompt`, `model`, nếu cần thì thêm `mask`. ## Phản hồi | Tham số | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `data[]` | array | | Ảnh hoàn thành: liên kết `url` hoặc dữ liệu `b64_json`, tùy theo mô hình. | Trước khi tạo ảnh, Ailoot giữ trước toàn bộ chi phí của kết quả. Ảnh đắt hơn văn bản, vì vậy hãy duy trì số dư dự trữ. Giá theo ảnh hoặc theo token hình ảnh có trong [danh mục](https://ailoot.ai/models/vi/?kind=image). ## Chỉnh sửa · multipart/form-data ```bash : "${AILOOT_IMAGE_EDIT_MODEL:?Select a model whose actual card or GET /v1/models method supports /v1/images/edits}" curl --fail-with-body --max-time 300 \ -D image-edit-headers.txt -o image-edit.json \ https://api.ailoot.ai/v1/images/edits \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -F "model=$AILOOT_IMAGE_EDIT_MODEL" \ -F 'prompt=Keep the subject and replace the background with a sunset' \ -F 'image=@input.png' ``` `input.png` → `image-edit.json` → `data[]` → `url | b64_json` ```python import base64 import json import mimetypes import os from pathlib import Path import time from urllib.parse import urljoin, urlsplit from urllib.request import Request, urlopen origin = "https://api.ailoot.ai" out = Path("image-edit-results") out.mkdir(exist_ok=True) def save_all(data): rows = data.get("data", []) if not rows: raise RuntimeError("No completed image data; keep the original response") for index, row in enumerate(rows, 1): if row.get("b64_json"): content = base64.b64decode(row["b64_json"], validate=True) suffix = ".png" if content.startswith(b"\x89PNG") else ".bin" elif row.get("url"): url = row["url"] if urlsplit(url).scheme != "https": raise ValueError("Expected the exact returned HTTPS image URL") # Signed result URLs are downloaded without sending the API key to another host. with urlopen(url, timeout=300) as response: content = response.read() suffix = mimetypes.guess_extension(response.headers.get_content_type()) or ".bin" else: raise RuntimeError("Image has neither url nor b64_json") (out / ("image-%03d" % index + suffix)).write_bytes(content) with open("image-edit.json", encoding="utf-8") as response: save_all(json.load(response)) ``` ## Images · async OpenAI SDK và Anthropic SDK thường tự động gửi lại khi gặp lỗi mạng và 5xx. Hãy tắt hành vi này khi tạo nội dung (`max_retries=0`) và kiểm tra `X-Should-Retry` trước khi thử lại. Không nhận được phản hồi không có nghĩa là yêu cầu chưa được thực hiện. ```python import base64 import json import mimetypes import os from pathlib import Path import time from urllib.parse import urljoin, urlsplit from urllib.request import Request, urlopen origin = "https://api.ailoot.ai" key = os.environ["AILOOT_API_KEY"] out = Path("image-results") out.mkdir(exist_ok=True) def api(url, payload=None): url = urljoin(origin, url) if urlsplit(url).scheme != "https" or urlsplit(url).netloc != "api.ailoot.ai": raise ValueError("Unexpected API origin") request = Request(url, data=None if payload is None else json.dumps(payload).encode(), headers={"Authorization": "Bearer " + key, "Content-Type": "application/json"}) with urlopen(request, timeout=300) as response: headers = dict(response.headers) data = json.load(response) (out / "response-headers.json").write_text(json.dumps(headers, indent=2)) return data, headers def save_all(data): rows = data.get("data", []) if not rows: raise RuntimeError("No completed image data; keep the original response") for index, row in enumerate(rows, 1): if row.get("b64_json"): content = base64.b64decode(row["b64_json"], validate=True) suffix = ".png" if content.startswith(b"\x89PNG") else ".bin" elif row.get("url"): url = row["url"] if urlsplit(url).scheme != "https": raise ValueError("Expected the exact returned HTTPS image URL") # Signed result URLs are downloaded without sending the API key to another host. with urlopen(url, timeout=300) as response: content = response.read() suffix = mimetypes.guess_extension(response.headers.get_content_type()) or ".bin" else: raise RuntimeError("Image has neither url nor b64_json") (out / ("image-%03d" % index + suffix)).write_bytes(content) # One POST. If its result is unknown, preserve it and check history; do not rerun creation. task, headers = api("/v1/images/generations/async", { "model": "gpt-image-2.5", "prompt": "Watercolor lighthouse at dawn", "size": "1024x1024"}) (out / "created-task.json").write_text(json.dumps(task, indent=2)) task_id = task.get("task_id") or task.get("id") poll_url = task.get("poll_url") or headers.get("Location") or headers.get("location") if not task_id or not poll_url: raise RuntimeError("Keep the create response and Request ID; do not submit again") for poll in range(60): task, headers = api(poll_url) # Read the original task with the same key. (out / "task-status.json").write_text(json.dumps(task, indent=2)) if task.get("status") == "completed": result = task["result"] (out / "image-response.json").write_text(json.dumps(result, indent=2)) save_all(result) break if task.get("status") == "failed": raise RuntimeError(json.dumps(task.get("error"))) if task.get("status") != "processing" or task.get("result_pending_check"): raise RuntimeError("Keep the original task ID and check it later; no new POST") time.sleep(min(60, max(1, int(headers.get("Retry-After", headers.get("retry-after", "3")))))) else: raise TimeoutError("Polling stopped; resume GET reads using created-task.json, never repeat POST") ``` Còn câu hỏi? Hãy gửi Request ID và mô tả — chúng tôi sẽ giúp tìm hiểu.[Liên hệ hỗ trợ](mailto:support@ailoot.ai) ## Ailoot · Công ty và danh mục dự án của công ty Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục. Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng. Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.