# Tài liệu dành cho tác nhân AI

Tài liệu này được xây dựng để các trợ lý AI cũng như con người đọc được. Cung cấp cho tác nhân của bạn một trong các điểm truy cập dưới đây và
nó có thể viết mã tích hợp chính xác mà không cần đoán tên tham số hoặc giá.

## Điểm truy cập

| URL | Nội dung |
|---|---|
| [https://doitong.com/developers/llms.txt](https://doitong.com/developers/llms.txt) | Chỉ mục theo định dạng [llms.txt](https://llmstxt.org): mọi hướng dẫn và mô hình, mỗi mục có mô tả một dòng. |
| [https://doitong.com/developers/llms-full.txt](https://doitong.com/developers/llms-full.txt) | Toàn bộ hướng dẫn, toàn bộ các mô hình nổi bật và thông tin thiết yếu của tất cả 1.496 mô hình (id, nhà phát triển, giá, liên kết tới trang đầy đủ) trong một tệp Markdown. |
| `/<lang>/developers/llms.txt` | Cùng một chỉ mục với hướng dẫn bằng ngôn ngữ khác của trang web, ví dụ `https://doitong.com/de/developers/llms.txt` (tiếng Anh là mặc định). |
| `<any page>.md` | Bản Markdown tương ứng của một trang, ví dụ [https://doitong.com/developers/models/flux/schnell.md](https://doitong.com/developers/models/flux/schnell.md) hoặc [https://doitong.com/developers/docs/quickstart.md](https://doitong.com/developers/docs/quickstart.md). |
| `/developers/models/<id>/llms.txt` | Giống với bản `.md` tương ứng của mô hình. |
| [https://doitong.com/developers/openapi.json](https://doitong.com/developers/openapi.json) | OpenAPI 3.1 dành cho trình tạo mã: mọi điểm cuối và nội dung yêu cầu có kiểu của các mô hình nổi bật; `?model=<id>`, `?category=<id>` hoặc `?models=all` sẽ thêm các mô hình khác. |
| `https://api.doitong.com/v1/models` | Danh mục dưới dạng JSON (không cần khóa). |

Trang Markdown của mỗi mô hình có giá bằng USD và tín dụng API, mọi tham số cùng tất cả giá trị được phép, ví dụ chỉ gồm tham số bắt buộc và ví dụ
đầy đủ, cấu trúc phản hồi, cùng mã sẵn dùng cho curl, JavaScript, Python và MCP.

## Sao chép cho AI

Mỗi trang mô hình có nút **Sao chép cho AI**: sao chép trang dưới dạng Markdown hoặc mở trang trong ChatGPT hay Claude với một
lời nhắc trỏ trợ lý tới phiên bản Markdown.

## Một lời nhắc hiệu quả

Dán nội dung này vào Claude, ChatGPT hoặc Cursor, sau đó mô tả điều bạn muốn xây dựng:

```text Lời nhắc
I want to generate images/video/audio with the Doitong API.
Read https://doitong.com/developers/llms.txt first, then the .md page of each model you plan to use.
Facts: base URL https://api.doitong.com/v1; auth header "Authorization: Bearer <key>" with the key from the
DOITONG_API_KEY environment variable; run with POST /run/{model_id}?wait=20 and, if the status is
still queued or running, poll GET /requests/{id}?wait=20; outputs[].url are file URLs on Doitong storage
(kept forever by default; add ?storage=temporary for throwaway runs, deleted after 7 days).
Get the price first with POST /quote/{model_id} (same body): exact, or for a model charged by usage the
most the run can cost (the unused part is refunded). Prices are in USD; 1000 API credits = 1 USD.
Use the parameter names from the model page; never invent parameters.
```

## Để tác nhân tự gọi mô hình

Để tác nhân tạo phương tiện trực tiếp, hãy kết nối [máy chủ MCP](https://doitong.com/developers/docs/mcp) bằng một khóa có
ngân sách bằng tín dụng API. Khi đó tác nhân có các công cụ để tìm mô hình, báo giá, chạy và lấy kết quả, đồng thời không thể tiêu dùng nhiều hơn
ngân sách.