Chuyển đến nội dung chính
Kỹ năng này hướng dẫn coding agent của bạn cách tích hợp 300+ AI APIs của LemonData chỉ bằng cách mô tả những gì bạn cần. Nó được đóng gói thành một kỹ năng dùng chung agent-first và hoạt động với bất kỳ coding agent nào hỗ trợ file skill hoặc rules.API là Agent-First — ngay cả khi agent đoán sai tên model, phản hồi lỗi sẽ cho biết chính xác cách khắc phục.
Trang này mô tả một lớp đóng gói skill có thể tái sử dụng, chứ không phải một bề mặt tương thích giao thức. Nếu bạn cần thiết lập điểm cuối, SDK hoặc client, hãy dùng các trang tích hợp chuyên biệt cho từng công cụ.

Cách hoạt động

  1. Bạn mô tả những gì bạn 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 điểm cuối
  3. Nếu có bất kỳ lỗi nào 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ố đúng
  5. Bạn nhận được code hoạt động — thường là ở lần thử đầu tiên hoặc lần thứ hai

Cài đặt

Sử dụng lệnh cài đặt không tương tác chính thức:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y
Lệnh này cài đặt kỹ năng dùng chung lemondata-api-integration từ repository skills của LemonData.Nếu công cụ của bạn không hỗ trợ trình cài đặt, hãy sao chép thư mục skills/lemondata-api-integration/ từ repository vào thư mục skills hoặc rules dùng chung của công cụ.

Xác minh cài đặt

Hỏi coding agent của bạn:
Có những skills nào khả dụng?
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 đến Dashboard → API Keys và tạo 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 kỹ năng này, agent sẽ yêu cầu key của bạn và đưa nó vào code được tạo ra.

Ví dụ

Chat Completion

Bạn nói:
Tôi muốn sử dụng GPT-4 trong dự án Python của mình
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-5.4",
    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-5.4",
    "suggestions": [{"id": "gpt-5.4"}, {"id": "gpt-5-mini"}],
    "hint": "Did you mean 'gpt-5.4'? Use GET https://api.lemondata.cc/v1/models to list all available models."
  }
}
Agent đọc did_you_mean, sửa tên model và thử lại — tất cả đều tự động.

Tạo ảnh

Bạn nói:
Generate images with Flux in Node.js
Agent gọi image API, xử lý lỗi và tạo code 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 code với điểm cuối /v1/audio/transcriptions chính xác và xử lý file âm thanh.

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

Mỗi phản hồi lỗi đều 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 chiếu Agent-First API đầy đủ để biết 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
Số dư không đủbalance_usd + suggestions rẻ hơnChuyển sang model có chi phí phù hợp
Model không khả dụngalternatives + retry_afterChuyển sang model khả dụng
Bị 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 điểm cuối native

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 điểm cuối native để có hiệu năng tốt hơn (không chuyển đổi định dạng, extended thinking, prompt caching).

Khám phá model

Không cần tìm kiếm trong tài liệu:
# Machine-readable API overview
curl https://api.lemondata.cc/llms.txt

# List models by category
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"

# Filter by capability
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-5.4, Claude, Gemini, DeepSeek
Tạo ảnhMidjourney, Flux, Stable Diffusion
Tạo videoSora, Runway, Kling, Luma AI
Tạo nhạcSuno
Mô hình 3DTripo3D
AudioText-to-Speech, Speech-to-Text
Embeddingstext-embedding-3
Rerankbce-reranker, qwen3-rerank

Thực tiễn 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 vào git hoặc để lộ chúng trong code frontend.

Quản lý chi phí

Đặt giới hạn sử dụng trong dashboard. Kiểm tra error.balance_usd để theo dõi chi phí theo chương trình.

Hãy nói trực tiếp

Hãy nói “Tôi muốn tạo ảnh bằng Python” thay vì “LemonData có image API 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 so với “Dùng GPT-4”.

Câu hỏi thường gặp

Hãy thử nhắc đến “LemonData” hoặc “LemonData API” trong yêu cầu của bạn:
Tôi muốn dùng LemonData để tích hợp GPT-4 vào dự án của mình
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 đúng và suggestions với các lựa chọn thay thế. Agent đọc các thông tin này và tự động sửa ở lần thử tiếp theo.
Bất kỳ coding agent nào hỗ trợ thư mục skill hoặc rules dùng chung. Khi trình cài đặt được hỗ trợ, npx skills add sẽ tự động đặt kỹ năng dùng chung lemondata-api-integration vào vị trí được phát hiện.
Chạy lại trình cài đặt:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y

Tài nguyên

Agent-First API

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

Tài liệu API

Tài liệu tham chiếu API đầy đủ

Models

Duyệt tất cả 300+ model khả dụng

llms.txt

Tổng quan API machine-readable cho AI agents
Có câu hỏi? Hãy xem GitHub Issues của chúng tôi hoặc liên hệ [email protected]