LMArena 편집하기 (부분)

== API 사용법 ==

LMArena는 개발자들을 위한 포괄적인 API를 제공한다. RESTful API 형식으로 설계되어 있으며, 주요 엔드포인트들은 다음과 같다.

모델 목록을 조회하는 엔드포인트는 `GET /api/v1/models`로 접근할 수 있으며, 현재 플랫폼에서 사용 가능한 모든 모델들의 정보를 반환한다:

<syntaxhighlight lang="bash">
curl -X GET "https://api.lmarena.ai/v1/models" \
     -H "Authorization: Bearer YOUR_API_KEY"
</syntaxhighlight>

응답 예시는 다음과 같은 JSON 형식으로 제공된다:

<syntaxhighlight lang="json">
{
  "models": [
    {
      "id": "gpt-4-turbo",
      "name": "GPT-4 Turbo",
      "provider": "OpenAI",
      "current_elo": 1832,
      "total_battles": 15420,
      "win_rate": 0.68
    },
    {
      "id": "claude-3-opus",
      "name": "Claude 3 Opus",
      "provider": "Anthropic",
      "current_elo": 1798,
      "total_battles": 12305,
      "win_rate": 0.65
    }
  ]
}
</syntaxhighlight>

새로운 배틀을 생성하려면 `POST /api/v1/battles` 엔드포인트를 사용한다:

<syntaxhighlight lang="python">
import requests

def create_battle(prompt, model1_id=None, model2_id=None):
    url = "https://api.lmarena.ai/v1/battles"
    headers = {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }
    
    data = {
        "prompt": prompt,
        "model1_id": model1_id,  # None이면 랜덤 선택
        "model2_id": model2_id,  # None이면 랜덤 선택
        "temperature": 0.7,
        "max_tokens": 1000
    }
    
    response = requests.post(url, json=data, headers=headers)
    return response.json()
</syntaxhighlight>

배틀 결과를 제출하는 엔드포인트는 `POST /api/v1/battles/{battle_id}/vote`를 통해 접근할 수 있다:

<syntaxhighlight lang="python">
def submit_vote(battle_id, winner):
    url = f"https://api.lmarena.ai/v1/battles/{battle_id}/vote"
    headers = {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }
    
    data = {
        "winner": winner,  # "model1", "model2", 또는 "tie"
        "feedback": "선택적 피드백 메시지"
    }
    
    response = requests.post(url, json=data, headers=headers)
    return response.json()
</syntaxhighlight>