Skip to main content
The Agents API is the control plane for programmatic account management. It supports a fully headless workflow from signup to API key creation with no browser required. For content generation, use the existing generation APIs (/api/v6, /api/v7, /api/v8) with your API key.

​
Base URL

https://modelslab.com/api/agents/v1

​
Authentication Model Split

  • Agents API (/api/agents/v1): Bearer token (Sanctum personal access token)
  • Generation APIs (/api/v6, /api/v7, /api/v8): existing API key flow continues
Token issuance supports token_expiry on login:
  • 1_week
  • 1_month (default)
  • 3_months
  • never
Use a Bearer token to manage account and billing operations. Use API keys for generation requests via /api/v6, /api/v7, /api/v8.

​
Standard Response Envelope (Agents API)

{
  "data": {},
  "error": null,
  "meta": {
    "request_id": "<request-id>"
  }
}
Error shape: 
{
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "Human readable message",
    "details": {}
  },
  "meta": {
    "request_id": "<request-id>"
  }
}

​
Rate Limiting

Agents API uses dedicated limiters. All responses include X-RateLimit-Remaining and X-RateLimit-Reset headers.
  • agent-auth: signup/login/forgot/reset/resend verification
  • agent-billing: payment methods, wallet funding, coupon redemption, subscription mutations, server deployment
  • agent-general: authenticated control-plane endpoints

​
Endpoint Groups

Authentication

Signup, login, logout, headless email verification, token refresh, and password reset.

Profile & API Keys

Read/update profile and manage API keys.

Usage & Models

Usage summaries/history and model discovery APIs.

Billing & Wallet

Payment methods, SetupIntent for headless card tokenization, billing info, invoices, wallet transactions, and wallet funding.

Subscriptions

Discover plans, pay-as-you-go options, direct headless subscriptions, and manage subscription lifecycle.

Training

Start and monitor model training and fine-tuning jobs.

Servers

Deploy and manage custom/enterprise dedicated servers.

Uploads

Presigned URL and base64 file uploads for training and generation.

Teams

Team members, invites, and invitation acceptance.

Headless Agent Flow

Complete account-to-generation walkthrough in 6 steps with no browser.

Compatibility Notes

Verification compatibility route and removed legacy endpoints.