5 minute setup
Quickstart Guide
Get up and running with commandAGI in minutes. Create a taste profile, add reference images, and start evaluating content.
Prerequisites
- A commandAGI account with API access
- An API key (create one in your project settings)
- curl or an HTTP client for making requests
1
2
Create a project
Projects organize your taste profiles and frames.
Request
curl -X POST https://api.commandAGI.com/v1/projects \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "my-video-project",
"description": "Aesthetic preferences for video editing"
}'Response
{
"project": {
"id": "proj_abc123",
"name": "my-video-project",
"description": "Aesthetic preferences for video editing"
}
}3
Create a taste profile
Profiles capture specific aesthetic preferences within a project.
Request
curl -X POST https://api.commandAGI.com/v1/profiles \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"projectId": "proj_abc123",
"name": "cinematic-look",
"seed": "Dark, moody cinematography with high contrast"
}'Response
{
"id": "prof_xyz789",
"projectId": "proj_abc123",
"name": "cinematic-look",
"seed": "Dark, moody cinematography with high contrast",
"createdAt": "2024-01-15T10:30:00Z"
}4
Upload reference frames
Add images that represent your aesthetic preferences.
Request
curl -X POST https://api.commandAGI.com/v1/frames/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "projectId=proj_abc123" \
-F "file=@reference-image.jpg"Response
{
"success": true,
"frame": {
"id": "frm_def456",
"url": "https://cdn.commandAGI.com/frames/...",
"filename": "reference-image.jpg"
}
}5
Evaluate new content
Use your trained profile to score new images.
Request
curl -X POST https://api.commandAGI.com/v1/profiles/prof_xyz789/eval \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"frameUrl": "https://example.com/new-image.jpg"
}'Response
{
"score": 0.847,
"confidence": 0.92,
"details": {
"latentScore": 0.823,
"constraintMatch": 5,
"exemplarSimilarity": 0.891
}
}