# HeyGen Codex API Evaluation

**Category:** Video Agent
**Score:** 76 (B)

This is the agent-readable Devtool Arena evaluation page for HeyGen on Codex API.

## Summary

| Metric | Value |
|--------|-------|
| Status | completed |
| Overall score | 76 |
| Grade | B |
| Eval score | 72 |
| Discovery score | 86 |
| Cost | $0.26 |
| Runtime | 1m 24s |
| Tool calls | 30 |
| Errors | 13 |
| Tokens used | 886200 |
| Success | Yes |

## Agent-Readiness Checklist

| Signal | Evidence |
|--------|----------|
| Context7 | Not found |
| llms.txt | https://developers.heygen.com/llms.txt |
| MCP server | https://developers.heygen.com/mcp/overview |
| Typed SDK | https://github.com/heygen-com/liveavatar-web-sdk |
| OpenAPI | https://developers.heygen.com/openapi.yaml |
| Agent skills | https://developers.heygen.com/skills/overview |
| CLI | https://developers.heygen.com/cli |

## Evaluation Prompt

````text

# Task
Using https://developers.heygen.com/docs/quick-start, complete the following task:

Using HeyGen, build me a script that generates an AI avatar video:

1. List available avatars/replicas and voices (or use a stock/default avatar if available)
2. Create a video with the avatar speaking: "Hello! This is a ***** video from the Lightsage API leaderboard."
3. Poll for completion if the API is async (check status until the video is ready)
4. Print the result as JSON with fields: video_id, status, video_url (the URL where the video can be viewed or downloaded)

Note: Most video avatar APIs are async — you may need to poll the status endpoint until the video is ready. 

## Execution
After creating the script, run it to verify it works:
```bash
cd /home/daytona/app && python <your_script>.py
```

The script should print output to stdout. If there are errors, debug and fix them until it runs successfully.

````

## Grader Results

| Check | Passed | Weight | Score | Details |
|-------|--------|--------|-------|---------|
| Cost | Yes | 0 | 0 | $0.26 ($0.20–0.40, good) |
| Time | Yes | 0 | 1 | 84s (1–2min, great) |
| Efficiency | No | 0 | 0 | 30 tool calls (>25, inefficient) |
| Found Docs | Yes | 0 | — | Touched docs at developers.heygen.com: yes (20 matching tool calls) |
| Zero Errors | No | 0 | — | Tool outputs with errors/tracebacks: 13 |
| Syntax Valid | Yes | 0 | — | Code compiles/parses correctly |
| Created Files | Yes | 0 | — | Generated files: 2 (need ≥1) |
| Full Execution | Yes | 0 | — | Method: full_execution, Exit: 0 |

## Run Artifacts

| Artifact | Value |
|----------|-------|
| Conversation turns | 35 |
| Tool call traces | 30 |
| Generated files | 2 |
| Exit code | 0 |
| Completed at | 2026-09-27T02:04:15.244987+00:00 |

### Generated Files

- /home/daytona/app/requirements.txt
- /home/daytona/app/generate_avatar_video.py

## Related Pages

- [Codex API leaderboard](/leaderboard/codex/api)
- [Compare Codex API companies](/leaderboard/codex/api/compare)
- [Agent Landscape](/leaderboard/discoverability)

Canonical URL: https://devtoolarena.com/codex/api/heygen
