Skip to main content

​
Profile Endpoints

MethodEndpointAuthPurpose
GET/api/agents/v1/meBearer tokenGet account profile, preferences, and wallet summary
PATCH/api/agents/v1/meBearer tokenUpdate profile fields
PATCH/api/agents/v1/me/preferencesBearer tokenUpdate preference fields

​
Update profile example

curl --request PATCH 'https://modelslab.com/api/agents/v1/me' \
  --header 'Authorization: Bearer <agent_access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Agent Runner",
    "username": "agent-runner",
    "about_me": "Automation account"
  }'

​
Update preferences example

curl --request PATCH 'https://modelslab.com/api/agents/v1/me/preferences' \
  --header 'Authorization: Bearer <agent_access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "nsfw_content": false,
    "wallet_notification_enabled": true,
    "wallet_notification_threshold": 10
  }'

​
API Key Endpoints

MethodEndpointAuthPurpose
GET/api/agents/v1/api-keysBearer tokenList API keys
POST/api/agents/v1/api-keysBearer tokenCreate API key
GET/api/agents/v1/api-keys/{id}Bearer tokenGet API key details
PUT/api/agents/v1/api-keys/{id}Bearer tokenUpdate API key metadata
DELETE/api/agents/v1/api-keys/{id}Bearer tokenDelete API key

​
Create API key example

curl --request POST 'https://modelslab.com/api/agents/v1/api-keys' \
  --header 'Authorization: Bearer <agent_access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Production Key",
    "notes": "Used by orchestrator"
  }'

​
Use API key for generation APIs

Generation endpoints still use API key flow. Example: /api/v6/images/text2img with key in payload.