cicora.ai
Đặc tả APITạo hình ảnh

Hình ảnh

Tạo hình ảnh qua một tuyến và chọn tham số từ năng lực của mô hình đã chọn.

Tài liệu tham khảo tích hợp: chọn tham số và năng lực khả dụng từ cài đặt API tài khoản và danh mục mô hình cho môi trường của bạn.

Tạo nội dung

Một yêu cầu chứa model, prompt và chỉ những tham số áp dụng cho tệp kết quả: kích thước, tỷ lệ khung hình, định dạng hoặc số lượng kết quả.

Không dùng mô hình văn bản làm mã định danh hình ảnh: chọn mô hình theo phương thức trong danh mục.

Yêu cầu tạo hình ảnh
bash
curl --request POST https://cicora.ai/api/v1/images \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/gemini-2.5-flash-image",
    "prompt": "A precise editorial illustration of a delivery route at dusk",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Tham chiếu và chỉnh sửa

  • Chỉ gửi hình ảnh tham chiếu qua input_references theo dạng được mô hình đã chọn hỗ trợ.
  • Chuyển đổi hình ảnh sang hình ảnh và chỉnh sửa dùng cùng tuyến /images với tham chiếu nguồn và hướng dẫn bằng văn bản.
  • Kiểm tra kiểu MIME, kích thước và quyền của tệp đầu vào trước khi gửi.

Nhận tệp kết quả

Trong phản hồi tương thích, đọc data[].b64_json dưới dạng byte hình ảnh; media_type có thể xác định định dạng. Lưu siêu dữ liệu cùng câu lệnh và mô hình.

Không công bố kết quả một phần như kết quả cuối cùng. Khi trả kết quả theo chế độ phát trực tiếp, hãy phân biệt sự kiện bản nháp với tệp kết quả đã hoàn tất.