Skip to main content

​
1. Get Your API Key

Contact your administrator to obtain an API key for authentication.

​
2. Create Your First Judge

Create a judge to evaluate content based on your criteria: 
curl -X POST https://api.judge.example.com/judges \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Content Quality Judge",
    "description": "Evaluates content for clarity and accuracy",
    "content_type": "text",
    "criteria": [
      {
        "name": "Clarity",
        "description": "How clear and understandable the content is"
      },
      {
        "name": "Accuracy",
        "description": "Factual correctness of the information"
      }
    ]
  }'
Save the judge ID from the response - you’ll need it for evaluations.

​
3. Upload Content

Upload text content to evaluate: 
curl -X POST https://api.judge.example.com/content/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "text_content=This is a sample article about artificial intelligence and its applications in modern business." \
  -F "name=AI Article" \
  -F "file_type=text"

​
4. Evaluate Content

Submit your content for evaluation: 
curl -X POST https://api.judge.example.com/evaluations/single \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content_id": "cnt_abc123",
    "judge_id": "jdg_xyz789"
  }'

​
5. Get Results

Retrieve the evaluation results: 
curl -X GET https://api.judge.example.com/evaluations/eval_def456 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Next Steps

Explore API Reference

Browse all available endpoints and their parameters

Video Content

Learn how to evaluate video content with AI

Batch Processing

Process multiple content items efficiently

Advanced Criteria

Create sophisticated evaluation criteria