메인 콘텐츠로 건너뛰기
이 스킬은 코딩 에이전트에게 필요한 내용을 설명하는 것만으로 LemonData의 300개 이상의 AI API를 통합하는 방법을 알려줍니다. 하나의 공유 Agent-First 스킬로 패키징되어 있으며, 스킬 또는 rules 파일을 지원하는 모든 코딩 에이전트에서 작동합니다.이 API는 Agent-First 입니다 — 에이전트가 모델 이름을 잘못 추측하더라도, 오류 응답이 이를 정확히 어떻게 수정해야 하는지 알려줍니다.
이 페이지는 재사용 가능한 스킬 패키징 계층을 설명하는 것이지, 프로토콜 호환 표면을 설명하는 페이지가 아닙니다. 엔드포인트, SDK, 클라이언트 설정이 필요하다면 해당 전용 통합 페이지를 참고하세요.
유형: 공유 스킬주요 경로: 재사용 가능한 공유 스킬을 통한 API 사용지원 수준: best-effort

​
작동 방식

  1. 필요한 것을 설명합니다 — “Python 프로젝트에서 GPT-4를 사용하고 싶어요”
  2. 에이전트가 API를 호출합니다 — 모델 이름이나 엔드포인트를 추측할 수 있습니다
  3. 문제가 발생하면 — API가 구조화된 힌트(did_you_mean, suggestions, retry_after)를 반환합니다
  4. 에이전트가 스스로 수정합니다 — 힌트를 읽고 올바른 parameter로 다시 시도합니다
  5. 동작하는 코드를 얻게 됩니다 — 일반적으로 첫 번째 또는 두 번째 시도에서 해결됩니다

​
설치

정식 비대화형 설치 명령을 사용하세요:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y
이 명령은 LemonData 스킬 저장소에서 공유 lemondata-api-integration 스킬을 설치합니다.도구가 installer를 지원하지 않는 경우, 저장소의 skills/lemondata-api-integration/ 폴더를 도구의 공유 스킬 또는 rules 디렉터리로 복사하세요.

​
설치 확인

코딩 에이전트에게 다음과 같이 물어보세요: 
사용 가능한 skills는 무엇인가요?
lemondata-api-integration가 보이면 설치가 성공한 것입니다.

​
API Key 받기

1

LemonData 방문

lemondata.cc로 이동합니다
2

로그인

계정을 생성하거나 로그인합니다
3

API Key 받기

Dashboard → API Keys로 이동하여 새 key를 생성합니다
4

Key 복사

key는 sk-...로 시작합니다 — 안전하게 저장하세요
API Key를 미리 설정할 필요는 없습니다. skill을 사용할 때 에이전트가 key를 요청하고 생성된 코드에 이를 포함합니다.

​
예시

​
Chat Completion

입력: 
Python 프로젝트에서 GPT-4를 사용하고 싶어요
에이전트가 생성하는 내용: 
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)
에이전트가 잘못된 모델 이름(예: gpt5)을 추측하면, API는 다음을 반환합니다: 
{
  "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."
  }
}
에이전트는 did_you_mean을 읽고, 모델 이름을 수정한 뒤 자동으로 다시 시도합니다.

​
이미지 생성

입력: 
Generate images with Flux in Node.js
에이전트는 image API를 호출하고, 오류를 처리하며, 다운로드 및 저장 로직이 포함된 완전한 코드를 생성합니다.

​
음성 인식

입력: 
Integrate speech-to-text in my app
에이전트는 올바른 /v1/audio/transcriptions 엔드포인트와 오디오 파일 처리가 포함된 코드를 생성합니다.

​
Agent-First 오류 복구

모든 오류 응답에는 어떤 코딩 에이전트든 파싱할 수 있는 구조화된 힌트가 포함됩니다. 자세한 내용은 전체 Agent-First API reference를 참조하세요.
오류API가 반환하는 내용에이전트가 수행하는 작업
잘못된 모델 이름did_you_mean + suggestions자동 수정 후 재시도
잔액 부족balance_usd + 더 저렴한 suggestions감당 가능한 모델로 전환
모델 사용 불가alternatives + retry_after사용 가능한 모델로 전환
Rate limit 초과retry_after (정확한 초 단위)대기 후 재시도
Context가 너무 김더 큰 모델이 포함된 suggestions더 큰 context 모델로 전환

​
네이티브 엔드포인트 최적화

Claude 또는 Gemini 모델로 /v1/chat/completions를 호출하면, API는 최적화 헤더를 반환합니다: 
X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages
에이전트는 더 나은 성능을 위해 자동으로 네이티브 엔드포인트로 전환합니다 (형식 변환 없음, 확장된 thinking, prompt caching).

​
모델 검색

문서를 검색할 필요가 없습니다: 
# 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"

​
지원되는 기능

유형예시
ChatGPT-5.4, Claude, Gemini, DeepSeek
이미지 생성Midjourney, Flux, Stable Diffusion
비디오 생성Sora, Runway, Kling, Luma AI
음악 생성Suno
3D 모델Tripo3D
오디오Text-to-Speech, Speech-to-Text
Embeddingstext-embedding-3
Rerankbce-reranker, qwen3-rerank

​
모범 사례

API Key 보안

환경 변수를 사용하세요. key를 git에 commit하거나 frontend 코드에 노출하지 마세요.

비용 관리

dashboard에서 사용량 제한을 설정하세요. error.balance_usd를 확인하여 비용을 프로그래밍 방식으로 모니터링하세요.

직접적으로 요청하세요

“LemonData에 image API가 있나요?” 대신 “Python에서 이미지를 생성하고 싶어요”라고 말하세요.

시나리오를 설명하세요

“GPT-4를 사용해”보다 “GPT-4로 chatbot을 만들고 있어”라고 말하면 에이전트에 더 많은 context를 제공합니다.

​
FAQ

요청에 “LemonData” 또는 “LemonData API”를 포함해 보세요:
LemonData를 사용해 내 프로젝트에 GPT-4를 통합하고 싶어요
LemonData의 Agent-First API는 구조화된 오류 힌트를 반환합니다. 에이전트가 잘못된 모델 이름을 추측하면, 오류에는 올바른 이름이 담긴 did_you_mean과 대안이 담긴 suggestions가 포함됩니다. 에이전트는 이를 읽고 다음 시도에서 자동으로 수정합니다.
공유 스킬 또는 rules 디렉터리를 지원하는 모든 코딩 에이전트가 가능합니다. installer가 지원되는 경우, npx skills add가 감지된 위치에 공유 lemondata-api-integration 스킬을 자동으로 배치합니다.
installer를 다시 실행하세요:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y

​
리소스

Agent-First API

구조화된 오류 힌트에 대한 전체 reference

API 문서

전체 API reference

모델

사용 가능한 300개 이상의 모든 모델 둘러보기

llms.txt

AI 에이전트를 위한 machine-readable API overview
질문이 있으신가요? GitHub Issues를 확인하거나 [email protected]로 문의하세요