Chuyển đến nội dung chính
Skill này hướng dẫn coding agent của bạn cách tích hợp bất kỳ API nào trong số hơn 300 AI API của LemonData chỉ bằng cách mô tả những gì bạn cần. Nó hoạt động với Claude Code, Cursor, GitHub Copilot, Windsurf và bất kỳ công cụ nào hỗ trợ các tệp skill/rules.API này được thiết kế theo chuẩn Agent-First — ngay cả khi agent đoán sai tên model, phản hồi lỗi sẽ cho nó biết chính xác cách khắc phục.

​
Cách thức hoạt động

  1. Bạn mô tả những gì mình cần — “Tôi muốn sử dụng GPT-4 trong dự án Python của mình”
  2. Agent gọi API — nó có thể đoán tên model hoặc endpoint
  3. Nếu có lỗi xảy ra — API trả về các gợi ý có cấu trúc (did_you_mean, suggestions, retry_after)
  4. Agent tự sửa lỗi — đọc các gợi ý và thử lại với các tham số chính xác
  5. Bạn nhận được mã hoạt động — thường là ngay lần thử đầu tiên hoặc thứ hai

​
Cài đặt

Tự động cài đặt cho tất cả các coding agent được phát hiện:
npx add-skill hedging8563/lemondata-api-skill -y
Hỗ trợ: Claude Code, Cursor, GitHub Copilot và nhiều hơn nữa.

​
Xác minh cài đặt

Hỏi coding agent của bạn: 
What skills are available?
Nếu bạn thấy lemondata-api-integration, việc cài đặt đã thành công.

​
Lấy API Key của bạn

1

Truy cập LemonData

Truy cập lemondata.cc
2

Đăng nhập

Tạo tài khoản hoặc đăng nhập
3

Lấy API Key

Đi tới Dashboard → API Keys và tạo một key mới
4

Sao chép Key

Key của bạn bắt đầu bằng sk-... — hãy lưu trữ nó một cách an toàn
Bạn không cần cấu hình API Key trước. Khi bạn sử dụng skill, agent sẽ hỏi key của bạn và đưa nó vào mã nguồn được tạo ra.

​
Ví dụ

​
Chat Completion

Bạn nói: 
I want to use GPT-4 in my Python project
Agent tạo ra: 
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.lemondata.cc/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)
Nếu agent đoán sai tên model (ví dụ: gpt5), API sẽ trả về: 
{
  "error": {
    "code": "model_not_found",
    "did_you_mean": "gpt-4o",
    "suggestions": [{"id": "gpt-4o"}, {"id": "gpt-4o-mini"}],
    "hint": "Did you mean 'gpt-4o'? Use GET /v1/models to list all available models."
  }
}
Agent đọc did_you_mean, sửa lại tên model và thử lại — tất cả đều tự động.

​
Tạo hình ảnh

Bạn nói: 
Generate images with Flux in Node.js
Agent gọi API hình ảnh, xử lý lỗi và tạo mã hoàn chỉnh với logic tải xuống và lưu tệp.

​
Nhận dạng giọng nói

Bạn nói: 
Integrate speech-to-text in my app
Agent tạo mã với endpoint /v1/audio/transcriptions chính xác và xử lý tệp âm thanh.

​
Khôi phục lỗi Agent-First

Mỗi phản hồi lỗi bao gồm các gợi ý có cấu trúc mà bất kỳ coding agent nào cũng có thể phân tích. Xem tài liệu tham khảo đầy đủ về Agent-First API để biết thêm chi tiết.
LỗiAPI trả về gìAgent làm gì
Sai tên modeldid_you_mean + suggestionsTự động sửa và thử lại
Không đủ số dưbalance_usd + suggestions rẻ hơnChuyển sang model có giá cả phải chăng
Model không khả dụngalternatives + retry_afterChuyển sang model khả dụng
Giới hạn tốc độretry_after (số giây chính xác)Chờ và thử lại
Context quá dàisuggestions với các model lớn hơnChuyển sang model có context lớn hơn

​
Tối ưu hóa Native Endpoint

Khi bạn gọi /v1/chat/completions với model Claude hoặc Gemini, API sẽ trả về các header tối ưu hóa: 
X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages
Agent tự động chuyển sang native endpoint để có hiệu suất tốt hơn (không cần chuyển đổi định dạng, hỗ trợ extended thinking, prompt caching).

​
Khám phá Model

Không cần tìm kiếm trong tài liệu: 
# Tổng quan API cho máy đọc
curl https://lemondata.cc/llms.txt

# Liệt kê model theo danh mục
curl "https://api.lemondata.cc/v1/models?category=chat" -H "Authorization: Bearer sk-KEY"
curl "https://api.lemondata.cc/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Lọc theo khả năng
curl "https://api.lemondata.cc/v1/models?tag=coding" -H "Authorization: Bearer sk-KEY"

​
Các khả năng được hỗ trợ

LoạiVí dụ
ChatGPT-4o, Claude, Gemini, DeepSeek
Tạo hình ảnhMidjourney, Flux, Stable Diffusion
Tạo videoSora, Runway, Kling, Luma AI
Tạo nhạcSuno
Model 3DTripo3D
Âm thanhText-to-Speech, Speech-to-Text
Embeddingstext-embedding-3
Rerankbce-reranker, qwen3-rerank

​
Thực hành tốt nhất

Bảo mật API Key

Sử dụng biến môi trường. Không bao giờ commit key lên git hoặc để lộ chúng trong mã frontend.

Quản lý chi phí

Thiết lập giới hạn sử dụng trong dashboard của bạn. Kiểm tra error.balance_usd để theo dõi chi phí bằng lập trình.

Nói trực tiếp

Hãy nói “Tôi muốn tạo hình ảnh bằng Python” thay vì “LemonData có API hình ảnh không?”

Mô tả tình huống của bạn

“Tôi đang xây dựng một chatbot với GPT-4” cung cấp cho agent nhiều ngữ cảnh hơn là “Sử dụng GPT-4”.

​
FAQ

Hãy thử nhắc đến “LemonData” hoặc “LemonData API” trong yêu cầu của bạn:
Use LemonData to integrate GPT-4 in my project
Agent-First API của LemonData trả về các gợi ý lỗi có cấu trúc. Nếu agent đoán sai tên model, lỗi sẽ bao gồm did_you_mean với tên chính xác và suggestions với các lựa chọn thay thế. Agent sẽ đọc những thông tin này và tự động sửa lỗi trong lần thử tiếp theo.
Bất kỳ công cụ nào hỗ trợ các tệp skill/rules: Claude Code, Cursor, GitHub Copilot, Windsurf và nhiều hơn nữa. Trình cài đặt npx add-skill sẽ tự động phát hiện và cài đặt cho tất cả các công cụ được hỗ trợ.
Chạy lại trình cài đặt:
npx add-skill hedging8563/lemondata-api-skill -y

​
Tài nguyên

Agent-First API

Tài liệu tham khảo đầy đủ cho các gợi ý lỗi có cấu trúc

Tài liệu API

Tài liệu tham khảo API đầy đủ

Models

Duyệt qua tất cả hơn 300 model có sẵn

llms.txt

Tổng quan API cho AI agent dưới dạng máy đọc
Bạn có thắc mắc? Kiểm tra GitHub Issues của chúng tôi hoặc liên hệ [email protected]