Một API key dùng được cho cả REST API, MCP server và Agent Skill. Agent tạo ảnh, video bằng credit trong tài khoản của bạn, lượt lỗi được hoàn credit như khi tạo trên web.
curl https://solart.app/api/v1/me \
-H "Authorization: Bearer slr_..."Solart có MCP server từ xa theo chuẩn Streamable HTTP. Thêm vào agent một lần là agent tự biết cách xem model, tải ảnh tham chiếu và tạo ảnh, video.
https://solart.app/api/mcpGửi API key trong header Authorization: Bearer slr_...claude mcp add --transport http solart https://solart.app/api/mcp \
--header "Authorization: Bearer slr_..."Client khác hỗ trợ Streamable HTTP chỉ cần địa chỉ MCP và header Authorization ở trên. Client chỉ hỗ trợ stdio thì dùng cầu nối mcp-remote như cấu hình Claude Desktop.
get_accountEmail và số dư creditlist_modelsModel đang bật, giá credit, tỉ lệ và độ phân giải hỗ trợlist_templatesMẫu prompt viết sẵnget_templateBiến cần điền của một mẫuupload_imageLưu ảnh tham chiếu từ URL hoặc base64generateTạo ảnh, video và chờ kết quả tới 45 giâyget_generationTrạng thái và link kết quả, có thể chờ thêmlist_generationsLịch sử tạo gần đâySkill là file SKILL.md hướng dẫn agent cách gọi API của Solart: chọn model, tải ảnh, tạo và chờ kết quả, xử lý lỗi. Phù hợp khi agent chạy được lệnh (curl) nhưng bạn không muốn cài MCP.
mkdir -p ~/.claude/skills/solart
curl -fsSL https://solart.app/skill.md -o ~/.claude/skills/solart/SKILL.mdexport SOLART_API_KEY="slr_..."Claude.ai và Claude Desktop: tải file zip rồi vào Settings > Capabilities > Skills > Upload skill.
Base URL bên dưới, mọi request gửi kèm header Authorization. Dữ liệu vào ra là JSON, link kết quả là URL tuyệt đối.
https://solart.app/api/v1GET/meTài khoản và số dư creditGET/modelsModel, giá và khả năng (lọc ?type=image|video)GET/templatesDanh sách mẫuGET/templates/{slug}Chi tiết mẫu và các biếnPOST/uploadsTải ảnh tham chiếu: multipart file, JSON url hoặc data base64GET/generationsLịch sử tạo, phân trang bằng beforePOST/generationsTạo ảnh, video. ?wait=55 để chờ kết quảGET/generations/{id}Trạng thái và kết quả. ?wait=55 để chờDELETE/generations/{id}Chuyển vào thùng ráccurl -X POST "https://solart.app/api/v1/generations?wait=55" \
-H "Authorization: Bearer slr_..." \
-H "Content-Type: application/json" \
-d '{
"mode": "custom",
"type": "image",
"prompt": "Cô gái mặc áo dài trắng bên hồ sen lúc bình minh",
"params": { "aspectRatio": "3:4" }
}'Tạo ảnh từ prompt và chờ kết quả trong cùng request.
{
"id": "8f0c...",
"type": "image",
"status": "succeeded",
"outputs": [
{
"type": "image",
"url": "https://solart.app/api/files/...",
"downloadUrl": "https://solart.app/api/files/...?download=1"
}
],
"error": null,
"creditCost": 24,
"refunded": false,
"filesExpireAt": "2026-10-13T09:00:00.000Z",
"webUrl": "https://solart.app/generations/8f0c..."
}Không có wait thì lượt tạo trả về ngay với status queued. Gọi GET /generations/:id?wait=55 lặp lại tới khi status là succeeded hoặc failed. Ảnh thường xong trong 10 đến 60 giây, video vài phút. File kết quả bị xoá sau filesExpireAt, hãy tải về nếu cần giữ.
Tối đa 20 lượt tạo mỗi phút cho mỗi tài khoản, cùng giới hạn số lượt đang chờ như trên web.
401API key thiếu, sai hoặc đã bị thu hồi (code invalid_api_key).402Không đủ credit, nạp thêm ở trang Bảng giá.422Tham số không hợp lệ: tỉ lệ, độ phân giải, thời lượng không có ở model hoặc thiếu biến của mẫu. Đọc error và details.429Vượt giới hạn tần suất hoặc số lượt đang chờ, đợi theo header Retry-After.status failed: lượt tạo lỗi, credit đã được hoàn (refunded: true).
Agent tự tìm hiểu được qua /llms.txt và openapi.json.