Bắt đầu nhanh

Bước 1: Tạo tài khoản

Mở AGTCloud để đăng ký tài khoản; nếu đã có tài khoản, bạn có thể đăng nhập.

Bước 2: Lấy API Key

1. Mở API Keys.
2. Nhấp vào Tạo Khóa API.
3. Sao chép và lưu API Key của bạn một cách an toàn.

Bước 3: Kiểm tra hạn mức khả dụng

Các lệnh gọi API sẽ tiêu thụ hạn mức của tài khoản. Trước khi gửi yêu cầu, hãy mở Số dư và nạp tiền để kiểm tra hạn mức khả dụng của tài khoản; phương thức nạp tiền và kết quả ghi nhận số dư được xác định theo thông tin trong bảng điều khiển.

Bước 4: Thực hiện lệnh gọi API đầu tiên

Các ví dụ dưới đây sử dụng địa chỉ API và mô hình mẫu của trang web hiện tại. Trước khi gọi API thực tế, hãy kiểm tra trên Danh mục mô hình xem API Key hiện tại có thể sử dụng mô hình tương ứng hay không.

Hội thoại với LLM

Bạn có thể gọi API tương thích Chat Completions bằng OpenAI SDK hoặc yêu cầu HTTP.

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.agtcloud.cn/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "Xin chào! Bạn có thể làm gì?"}
    ],
)

print(response.choices[0].message.content)

Văn bản phản hồi nằm trong choices[0].message.content. Xem thêm tham số tại Chat Completions.

Tạo hình ảnh

curl 'https://api.agtcloud.cn/v1/images/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "qwen-image",
    "prompt": "Một thành phố tương lai lơ lửng trên biển mây"
  }'

Tạo video

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "Một con tàu vũ trụ bay qua tinh vân màu xanh"
  }'

Sau khi tạo thành công, lưu task_id trong phản hồi, rồi truy vấn trạng thái và kết quả tác vụ:

curl 'https://api.agtcloud.cn/v1/video/generations/your-task-id' \
  -H 'Authorization: Bearer your-api-key'

Xem các trường đầy đủ và trạng thái tác vụ tại Tạo video và Truy vấn video.

Để kiểm tra yêu cầu trong trình duyệt, bạn có thể mở Playground.

Bước 5: Khám phá mô hình

Mở Danh mục mô hình để tìm mô hình phù hợp với tác vụ. Trước khi gọi API, hãy kiểm tra giao thức, tham số được mô hình hỗ trợ và quyền của tài khoản hiện tại.