ModelsLab

https://docs.modelslab.com/
Admin
ModelsLab is a comprehensive AI API suite providing developer-first access to advanced AI...
Tokens:349,690
Snippets:2,121
Trust Score:8.6
Update:2 months ago
Show doc for...
Tokens:
Raw
### Quickstart with GGUF Cloud SDKs and cURL

Source: https://docs.modelslab.com/gguf-cloud/overview

Examples for connecting to a GGUF Cloud deployment using OpenAI, Anthropic, and cURL interfaces.

```python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_MODELSLAB_API_KEY",
    base_url="https://modelslab.com/api/gguf/YOUR_DEPLOYMENT_ID/v1",
)

response = client.chat.completions.create(
    model="local",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)
```

```python
from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_MODELSLAB_API_KEY",
    base_url="https://modelslab.com/api/gguf/YOUR_DEPLOYMENT_ID",
)

message = client.messages.create(
    model="local",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)

print(message.content[0].text)
```

```bash
curl -X POST "https://modelslab.com/api/gguf/YOUR_DEPLOYMENT_ID/v1/chat/completions" \
  -H "Authorization: Bearer $MODELSLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "local",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

--------------------------------

### Install ModelQ via PyPI

Source: https://docs.modelslab.com/open-source/modelq/installation

Standard installation method using the Python package manager.

```bash
pip install modelq
```

--------------------------------

### Install ModelsLab Go SDK

Source: https://docs.modelslab.com/sdk/golang

Initialize a new Go module and install the ModelsLab SDK dependency.

```bash
go mod init your-project
go get github.com/modelslab/modelslab-go
```

--------------------------------

### System Details Request Examples

Source: https://docs.modelslab.com/enterprise-api/image-to-video-ultra/system-details

Implementation examples for fetching server status across multiple programming languages.

```javascript
var myHeaders = new Headers();myHeaders.append("Content-Type", "application/json");var raw = JSON.stringify({ "key": ""});var requestOptions = {  method: 'POST',  headers: myHeaders,  body: raw,  redirect: 'follow'};fetch("https://modelslab.com/api/v1/enterprise/image_to_video_ultra/system_details", requestOptions)  .then(response => response.text())  .then(result => console.log(result))  .catch(error => console.log('error', error));
```

```php
<?php$payload = [  "key" => ""];$curl = curl_init();curl_setopt_array($curl, array(  CURLOPT_URL => 'https://modelslab.com/api/v1/enterprise/image_to_video_ultra/system_details',  CURLOPT_RETURNTRANSFER => true,  CURLOPT_ENCODING => '',  CURLOPT_MAXREDIRS => 10,  CURLOPT_TIMEOUT => 0,  CURLOPT_FOLLOWLOCATION => true,  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,  CURLOPT_CUSTOMREQUEST => 'POST',  CURLOPT_POSTFIELDS => json_encode($payload),  CURLOPT_HTTPHEADER => array(    'Content-Type: application/json'  ),));$response = curl_exec($curl);curl_close($curl);echo $response;
```

```javascript
var request = require('request');var options = {  'method': 'POST',  'url': 'https://modelslab.com/api/v1/enterprise/image_to_video_ultra/system_details',  'headers': {    'Content-Type': 'application/json'  },  body: JSON.stringify({    "key": ""  })};request(options, function (error, response) {  if (error) throw new Error(error);  console.log(response.body);});
```

```python
import requestsimport jsonurl = "https://modelslab.com/api/v1/enterprise/image_to_video_ultra/system_details"payload = json.dumps({ "key": ""})headers = {  'Content-Type': 'application/json'}response = requests.request("POST", url, headers=headers, data=payload)print(response.text)
```

```java
OkHttpClient client = new OkHttpClient().newBuilder()  .build();MediaType mediaType = MediaType.parse("application/json");RequestBody body = RequestBody.create(mediaType, "{\n    \"key\": \"\"\n}");Request request = new Request.Builder()  .url("https://modelslab.com/api/v1/enterprise/image_to_video_ultra/system_details")  .method("POST", body)  .addHeader("Content-Type", "application/json")  .build();Response response = client.newCall(request).execute();
```

--------------------------------

### Update Server Implementation Examples

Source: https://docs.modelslab.com/enterprise-api/image-to-video-ultra/update-server

Client-side implementation examples for updating the server across various programming languages.

```javascript
var myHeaders = new Headers();myHeaders.append("Content-Type", "application/json");var raw = JSON.stringify({ "key": ""});var requestOptions = {  method: 'POST',  headers: myHeaders,  body: raw,  redirect: 'follow'};fetch("https://modelslab.com/api/v1/enterprise/image_to_video_ultra/update_server", requestOptions)  .then(response => response.text())  .then(result => console.log(result))  .catch(error => console.log('error', error));
```

```php
<?php$payload = [  "key" => ""];$curl = curl_init();curl_setopt_array($curl, array(  CURLOPT_URL => 'https://modelslab.com/api/v1/enterprise/image_to_video_ultra/update_server',  CURLOPT_RETURNTRANSFER => true,  CURLOPT_ENCODING => '',  CURLOPT_MAXREDIRS => 10,  CURLOPT_TIMEOUT => 0,  CURLOPT_FOLLOWLOCATION => true,  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,  CURLOPT_CUSTOMREQUEST => 'POST',  CURLOPT_POSTFIELDS => json_encode($payload),  CURLOPT_HTTPHEADER => array(    'Content-Type: application/json'  ),));$response = curl_exec($curl);curl_close($curl);echo $response;
```

```javascript
var request = require('request');var options = {  'method': 'POST',  'url': 'https://modelslab.com/api/v1/enterprise/image_to_video_ultra/update_server',  'headers': {    'Content-Type': 'application/json'  },  body: JSON.stringify({    "key": ""  })};request(options, function (error, response) {  if (error) throw new Error(error);  console.log(response.body);});
```

```python
import requestsimport jsonurl = "https://modelslab.com/api/v1/enterprise/image_to_video_ultra/update_server"payload = json.dumps({ "key": ""})headers = {  'Content-Type': 'application/json'}response = requests.request("POST", url, headers=headers, data=payload)print(response.text)
```

```java
OkHttpClient client = new OkHttpClient().newBuilder()  .build();MediaType mediaType = MediaType.parse("application/json");RequestBody body = RequestBody.create(mediaType, "{\n    \"key\": \"\"\n}");Request request = new Request.Builder()  .url("https://modelslab.com/api/v1/enterprise/image_to_video_ultra/update_server")  .method("POST", body)  .addHeader("Content-Type", "application/json")  .build();Response response = client.newCall(request).execute();
```

--------------------------------

### Install ModelQ via GitHub

Source: https://docs.modelslab.com/open-source/modelq/installation

Installation method for pulling the latest source code directly from the repository.

```bash
pip install git+https://github.com/ModelsLab/modelq.git
```

--------------------------------

### Example Good Captions

Source: https://docs.modelslab.com/guides/song-generation-guide

These examples demonstrate how to combine style, emotion, instruments, and texture to create effective music generation prompts.

```text
A modern reggaeton track with strong flamenco influence, featuring female vocal with reverb,
deep sub-bass, crisp percussion, and plucked synth guitar riff
```

```text
Lo-fi hip-hop beat with warm vinyl crackle, mellow piano chords, subtle jazz drums,
and atmospheric pad textures
```

```text
80s synthwave pop with bright synth leads, punchy drum machine, nostalgic atmosphere,
and powerful female vocals
```

--------------------------------

### Install and Manage ModelsLab Skills

Source: https://docs.modelslab.com/agent-skills

Use the Skills CLI to install all available skills, specific individual skills, or list the currently available options.

```bash
# Install all ModelsLab skills
npx skills add modelslab/skills --all

# Install a specific skill
npx skills add modelslab/skills --skill modelslab-image-generation

# List available skills
npx skills add modelslab/skills --list
```

--------------------------------

### Install ModelsLab Python SDK

Source: https://docs.modelslab.com/sdk/python

Install the package using pip.

```bash
pip install modelslab_py
```

--------------------------------

### Install ModelsLab SDK

Source: https://docs.modelslab.com/sdk/typescript

Install the package using npm or yarn.

```bash
npm install modelslab
```

```bash
yarn add modelslab
```

--------------------------------

### Launch OpenCode

Source: https://docs.modelslab.com/mcp-web-api/agent-integration

Start the OpenCode terminal interface.

```bash
opencode
```

--------------------------------

### Initialize Audio Client

Source: https://docs.modelslab.com/sdk/typescript

Setup the client and audio instance using your API key.

```javascript
import { Client, Audio } from "modelslab";

const client = new Client("your-api-key");
const audio = new Audio(client.key);

const result = await audio.textToAudio({
  key: client.key,
  prompt: "A calm piano melody with soft strings in the background",
  duration: 30  // Duration in seconds
});

console.log("Audio URL:", result.output[0]);
```

--------------------------------

### Fetch Dependencies

Source: https://docs.modelslab.com/sdk/dart

Run this command in your terminal to install the added dependencies.

```bash
dart pub get
```

--------------------------------

### Get Profile JSON-RPC Request

Source: https://docs.modelslab.com/mcp-web-api/agent-cp-tools-reference

Example of calling the agent-profile tool with the get action to retrieve user profile data.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agent-profile",
    "arguments": {
      "action": "get"
    }
  }
}
```

--------------------------------

### Workflow Request Body Example

Source: https://docs.modelslab.com/workflows-api/run-workflow

Example of the JSON payload required to initiate a workflow execution.

```json
{
  "prompt": "A beautiful sunset over mountains",
  "negative_prompt": "blurry, low quality",
  "width": 1024,
  "height": 1024
}
```

--------------------------------

### Text to Speech request body example

Source: https://docs.modelslab.com/enterprise-api/text-to-speech/text-to-speech

Example JSON payload for the text-to-speech generation request.

```json
{
    "key": "enterprise_api_key",
    "prompt":"Build next-generation AI products without worrying about GPUs",
    "language":"american english",
    "voice_id":"madison",
    "speed":1,
    "emotion":false
}
```

--------------------------------

### Initialize and use Video APIs

Source: https://docs.modelslab.com/sdk/dart

Demonstrates how to instantiate the Video client and call text-to-video or image-to-video generation methods.

```dart
import 'package:modelslab/core/apis/video.dart';
import 'package:modelslab/core/apis/base.dart';
import 'package:modelslab/schemas/video.dart';
import 'package:modelslab/core/client.dart';

var client = Client(key: "Your api key");
var api = Video(client: client);

//for text to video api.

var schema = Text2Video(...)
Future<Map<String, dynamic>> response = api.textToVideo(schema);

//for image to video api.

var schema = Image2Video(...)
Future<Map<String, dynamic>> response = api.imageToVideo(schema);
```

--------------------------------

### Basic Task Definition and Execution

Source: https://docs.modelslab.com/open-source/modelq/usage

Demonstrates initializing ModelQ with Redis, defining tasks with decorators, and starting workers.

```python
from modelq import ModelQ
from modelq.exceptions import RetryTaskException
from redis import Redis
import time

imagine_db = Redis(host="localhost", port=6379, db=0)
q = ModelQ(redis_client=imagine_db)

@q.task(timeout=10, retries=2)
def add(a, b):
    return a + b

@q.task(stream=True)
def stream_multiples(x):
    for i in range(5):
        time.sleep(1)
        yield f"{i+1} * {x} = {(i+1) * x}"

@q.task()
def fragile(x):
    if x < 5:
        raise RetryTaskException("Try again.")
    return x

q.start_workers()

task = add(2, 3)
print(task.get_result(q.redis_client))
```

--------------------------------

### Configure Custom Client Settings

Source: https://docs.modelslab.com/sdk/golang

Initialize the client with custom configuration options such as timeouts, retry counts, and base URL.

```go
import (
	"time"
	"github.com/modelslab/modelslab-go/pkg/client"
)

config := &client.Config{
	APIKey:       "your-api-key",
	BaseURL:      "https://modelslab.com/api/",
	FetchRetry:   10,
	FetchTimeout: 2 * time.Second,
	HTTPTimeout:  30 * time.Second,
}

c := client.NewWithConfig(config)
```

--------------------------------

### Initialize ModelsLab Client

Source: https://docs.modelslab.com/sdk/php

Demonstrates how to instantiate the ModelsLab client using a direct API key or with custom configuration options.

```php
<?php
use ModelsLab\ModelsLab;

// Method 1: Direct API key
$modelslab = new ModelsLab('your-api-key');

// Method 2: With custom options
$modelslab = new ModelsLab('your-api-key', [
    'base_url' => 'https://modelslab.com/api/',
    'fetch_retry' => 10,
    'fetch_timeout' => 2
]);
```

--------------------------------

### Load Model Request Examples

Source: https://docs.modelslab.com/image-generation/model-operation/upload-model

Examples of JSON request bodies for loading models from external URLs or diffusers paths.

```yaml
key: api_key
url: >-
  https://civitai.com/api/download/models/132760?type=Model&format=SafeTensor&size=pruned&fp=fp16
revision: fp32
model_id: stable-diffusion-1.0-inpainting-0.1
force_load: 'yes'
model_category: stable_diffusion_xl
model_format: safetensors
model_visibility: public
model_name: stable-diffusion-1.0-inpainting-0.1
model_image: >-
  https://cdn2.stablediffusionapi.com/generations/1a14cab3-cc79-4cee-ab28-29379bff766b-0.png
hf_upload: 'no'
```

```yaml
key: api_key
url: diffusers/stable-diffusion-xl-1.0-inpainting-0.1
model_id: stable-diffusion-xl-1.0-inpainting-0.1
force_load: 'yes'
revision: fp16
model_category: stable_diffusion_xl
model_format: diffusers
model_visibility: public
model_name: stable-diffusion-xl-1.0-inpainting-0.1
model_image: >-
  https://cdn2.stablediffusionapi.com/generations/1a14cab3-cc79-4cee-ab28-29379bff766b-0.png
hf_upload: 'no'
```

--------------------------------

### Create Account

Source: https://docs.modelslab.com/agents-api/headless-flow

Register a new account to begin the headless flow.

```bash
curl --request POST 'https://modelslab.com/api/agents/v1/auth/signup' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "agent@example.com",
    "password": "secret123",
    "name": "Agent Runner"
  }'
```

--------------------------------

### Flux Text-to-Image API Request Examples

Source: https://docs.modelslab.com/image-generation/flux/flux-text-to-image

Examples showing how to send a POST request to the Flux text-to-image endpoint using various programming languages and tools.

```json
{
    "key": "your_api_key",
    "model_id": "flux",
    "prompt": "ultra realistic close up portrait ((beautiful pale cyberpunk female with heavy black eyeliner)), blue eyes, shaved side haircut, hyper detail, cinematic lighting, magic neon, dark red city, Canon EOS R3, nikon, f/1.4, ISO 200, 1/160s, 8K, RAW, unedited, symmetrical balance, in-frame, 8K",
    "negative_prompt": "blurry, low quality, distorted, deformed",
    "width": 512,
    "height": 512,
    "samples": 1,
    "num_inference_steps": 31,
    "safety_checker": "no",
    "seed": null,
    "guidance_scale": 7.5,
    "clip_skip": 2,
    "lora_model": "more_details",
    "lora_strength": "0.8",
    "webhook": null,
    "track_id": null
}
```

```python
import requests

response = requests.post(
    "https://modelslab.com/api/v6/images/text2img",
    json={
        "key": "your_api_key",
        "model_id": "flux",
        "prompt": "ultra realistic portrait of a cyberpunk woman, blue eyes, cinematic lighting, 8K",
        "negative_prompt": "blurry, low quality, distorted",
        "width": 512,
        "height": 512,
        "samples": 1,
        "num_inference_steps": 31,
        "guidance_scale": 7.5
    }
)

data = response.json()
print(data)
```

```javascript
const response = await fetch("https://modelslab.com/api/v6/images/text2img", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    key: "your_api_key",
    model_id: "flux",
    prompt: "ultra realistic portrait of a cyberpunk woman, blue eyes, cinematic lighting, 8K",
    negative_prompt: "blurry, low quality, distorted",
    width: 512,
    height: 512,
    samples: 1,
    num_inference_steps: 31,
    guidance_scale: 7.5
  })
});

const data = await response.json();
console.log(data);
```

```bash
curl -X POST "https://modelslab.com/api/v6/images/text2img" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "your_api_key",
    "model_id": "flux",
    "prompt": "ultra realistic portrait of a cyberpunk woman, blue eyes, cinematic lighting, 8K",
    "negative_prompt": "blurry, low quality, distorted",
    "width": 512,
    "height": 512,
    "samples": 1,
    "num_inference_steps": 31,
    "guidance_scale": 7.5
  }'
```

--------------------------------

### Initialize and use Audio API

Source: https://docs.modelslab.com/sdk/dart

Demonstrates how to instantiate the Audio API client and execute requests for various audio generation and processing tasks.

```dart
import 'package:modelslab/core/apis/audio.dart';
import 'package:modelslab/core/apis/base.dart';
import 'package:modelslab/schemas/audio.dart';
import 'package:modelslab/core/client.dart';

var client = Client(key: "Your api key");
var api = Audio(client: client);

//for text to audio api.

var schema = Text2Audio(...)
Future<Map<String, dynamic>> response = api.textToAudio(schema);

//for text to speech api.

var schema = Text2Speech(...)
Future<Map<String, dynamic>> response = api.textToSpeech(schema);

//for voice to voice api.
var schema = Voice2Voice(...)
Future<Map<String, dynamic>> response = api.floor(schema);

//for voice cover api.
var schema = VoiceCover(...)
Future<Map<String, dynamic>> response = api.voiceCover(schema);

//for music gen api.
var schema = MusicGenSchema(...)
Future<Map<String, dynamic>> response = api.musicGen(schema);

//for lyrics api.
var schema = LyricsGenerator(...)
Future<Map<String, dynamic>> response = api.lyricsGen(schema);

//for song generator api.
var schema = SongGenerator(...)
Future<Map<String, dynamic>> response = api.songGenerator(schema);

//for speechto text api.
var schema = Speech2Text(...)
Future<Map<String, dynamic>> response = api.speechToText(schema);

//for sfx api.
var schema = SFX(...)
Future<Map<String, dynamic>> response = api.sfxGen(schema);
```

--------------------------------

### GET /wallet/coupons/validate

Source: https://docs.modelslab.com/llms.txt

Validates a coupon code.

```APIDOC
## GET /wallet/coupons/validate

### Description
Validates a coupon code.

### Method
GET

### Endpoint
/wallet/coupons/validate

### Parameters
#### Query Parameters
- **coupon_code** (string) - Required - The coupon code to validate
```

--------------------------------

### GET /subscriptions/plans

Source: https://docs.modelslab.com/llms.txt

Lists all available subscription plans.

```APIDOC
## GET /subscriptions/plans

### Description
Lists all available subscription plans.

### Method
GET

### Endpoint
/subscriptions/plans
```

--------------------------------

### Generate Text-to-Video with Go SDK

Source: https://docs.modelslab.com/sdk/golang

Initializes the video client and sends a request to generate a video from a text prompt using a specified model.

```go
package main

import (
	"context"
	"encoding/json"
	"fmt"

	"github.com/modelslab/modelslab-go/pkg/apis/video"
	"github.com/modelslab/modelslab-go/pkg/client"
	videoSchema "github.com/modelslab/modelslab-go/pkg/schemas/video"
)

func main() {
	c := client.New("your-api-key")
	videoAPI := video.New(c, false)

	req := videoSchema.Text2VideoRequest{
		Prompt:  "A cat playing with a ball in a sunny garden",
		ModelID: "cogvideox",
	}

	resp, err := videoAPI.TextToVideo(context.Background(), &req)
	if err != nil {
		panic(err)
	}

	prettyJSON, _ := json.MarshalIndent(resp, "", "  ")
	fmt.Println(string(prettyJSON))
}
```

--------------------------------

### GET /api/agents/v1/wallet/coupons/validate

Source: https://docs.modelslab.com/agents-api/billing-and-wallet

Validates a coupon code before it is redeemed.

```APIDOC
## GET /api/agents/v1/wallet/coupons/validate

### Description
Validates a coupon code before redeeming.

### Method
GET

### Endpoint
https://modelslab.com/api/agents/v1/wallet/coupons/validate

### Parameters
#### Query Parameters
- **coupon_code** (string) - Required - The coupon code to validate.
```

--------------------------------

### SDK Client Initialization

Source: https://docs.modelslab.com/gguf-cloud/authentication

Configuring OpenAI and Anthropic clients with the appropriate base URL and API key.

```python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_MODELSLAB_API_KEY",
    base_url="https://modelslab.com/api/gguf/YOUR_DEPLOYMENT_ID/v1",
)
```

```python
from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_MODELSLAB_API_KEY",
    base_url="https://modelslab.com/api/gguf/YOUR_DEPLOYMENT_ID",
)
```

--------------------------------

### GET /v1/models

Source: https://docs.modelslab.com/gguf-cloud/chat-completions

Lists the available models for the specified deployment.

```APIDOC
## GET /v1/models

### Description
Retrieves a list of models available for the deployment.

### Method
GET

### Endpoint
https://modelslab.com/api/gguf/YOUR_DEPLOYMENT_ID/v1/models
```

--------------------------------

### Initialize API Instances

Source: https://docs.modelslab.com/sdk/typescript

Create instances for specific API services using the client's API key.

```javascript
import { Community, Audio, Video, ImageEditing } from "modelslab";

// Create instances with your API key
const community = new Community(client.key);
const audio = new Audio(client.key);
const video = new Video(client.key);
const imageEditing = new ImageEditing(client.key);
```

--------------------------------

### GET /api/agents/v1/api-keys

Source: https://docs.modelslab.com/agents-api/profile-and-api-keys

Lists all API keys associated with the account.

```APIDOC
## GET /api/agents/v1/api-keys

### Description
Lists all API keys associated with the account.

### Method
GET

### Endpoint
/api/agents/v1/api-keys
```

--------------------------------

### Restart Server Implementation Examples

Source: https://docs.modelslab.com/enterprise-api/image-to-video-ultra/restart-server

Client-side implementations for restarting the server across various programming languages.

```javascript
var myHeaders = new Headers();myHeaders.append("Content-Type", "application/json");var raw = JSON.stringify({ "key": ""});var requestOptions = {  method: 'POST',  headers: myHeaders,  body: raw,  redirect: 'follow'};fetch("https://modelslab.com/api/v1/enterprise/image_to_video_ultra/restart_server", requestOptions)  .then(response => response.text())  .then(result => console.log(result))  .catch(error => console.log('error', error));
```

```php
<?php$payload = [  "key" => ""];$curl = curl_init();curl_setopt_array($curl, array(  CURLOPT_URL => 'https://modelslab.com/api/v1/enterprise/image_to_video_ultra/restart_server',  CURLOPT_RETURNTRANSFER => true,  CURLOPT_ENCODING => '',  CURLOPT_MAXREDIRS => 10,  CURLOPT_TIMEOUT => 0,  CURLOPT_FOLLOWLOCATION => true,  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,  CURLOPT_CUSTOMREQUEST => 'POST',  CURLOPT_POSTFIELDS => json_encode($payload),  CURLOPT_HTTPHEADER => array(    'Content-Type: application/json'  ),));$response = curl_exec($curl);curl_close($curl);echo $response;
```

```javascript
var request = require('request');var options = {  'method': 'POST',  'url': 'https://modelslab.com/api/v1/enterprise/image_to_video_ultra/restart_server',  'headers': {    'Content-Type': 'application/json'  },  body: JSON.stringify({    "key": ""  })};request(options, function (error, response) {  if (error) throw new Error(error);  console.log(response.body);});
```

```python
import requestsimport jsonurl = "https://modelslab.com/api/v1/enterprise/image_to_video_ultra/restart_server"payload = json.dumps({ "key": ""})headers = {  'Content-Type': 'application/json'}response = requests.request("POST", url, headers=headers, data=payload)print(response.text)
```

```java
OkHttpClient client = new OkHttpClient().newBuilder()  .build();MediaType mediaType = MediaType.parse("application/json");RequestBody body = RequestBody.create(mediaType, "{\n    \"key\": \"\"\n}");Request request = new Request.Builder()  .url("https://modelslab.com/api/v1/enterprise/image_to_video_ultra/restart_server")  .method("POST", body)  .addHeader("Content-Type", "application/json")  .build();Response response = client.newCall(request).execute();
```

--------------------------------

### GET /api/agents/v1/models

Source: https://docs.modelslab.com/agents-api/usage-and-models

Searches and filters the paginated model catalog.

```APIDOC
## GET /api/agents/v1/models

### Description
Searches and filters the paginated model catalog.

### Method
GET

### Endpoint
/api/agents/v1/models

### Parameters
#### Query Parameters
- **feature** (string) - Optional - Filter by feature
- **search** (string) - Optional - Search term
- **model_type** (string) - Optional - Filter by model type
- **model_subcategory** (string) - Optional - Filter by subcategory
- **base_model** (string) - Optional - Filter by base model
- **provider** (string) - Optional - Filter by provider
- **sort** (string) - Optional - Sort order (recommended, latest, most-used, asc, desc, sort-asc, sort-desc)
- **per_page** (integer) - Optional - Results per page
- **tags** (array/string) - Optional - Filter by tags
```

--------------------------------

### Start Pi Agent with ModelsLab

Source: https://docs.modelslab.com/llm-api/coding-tools

Set the API key environment variable and launch the Pi agent.

```bash
export MODELSLAB_API_KEY="YOUR_MODELSLAB_API_KEY"
pi --provider modelslab --model "YOUR_MODEL_ID"
```

--------------------------------

### GET /api/agents/v1/teams

Source: https://docs.modelslab.com/agents-api/teams

List all team members and pending invitations.

```APIDOC
## GET /api/agents/v1/teams

### Description
List team members and pending invites.

### Method
GET

### Endpoint
/api/agents/v1/teams
```

--------------------------------

### POST /enterprise/video/system_details

Source: https://docs.modelslab.com/enterprise-api/video/system-details

This endpoint returns information about your server.

```APIDOC
## POST /enterprise/video/system_details

### Description
This endpoint returns information about your server.

### Method
POST

### Endpoint
https://modelslab.com/api/v1/enterprise/video/system_details

### Request Body
- **key** (string) - Required - Your API key

### Request Example
{
  "key": "enterprise_api_key"
}

### Response
#### Success Response (200)
- **status** (string) - Status of the operation
- **message** (string) - Success message

#### Error Response (401)
- **status** (string) - Status of the operation
- **message** (string) - Error message

#### Response Example
{
  "status": "success",
  "message": "Operation completed successfully"
}
```

--------------------------------

### Create Account via Signup

Source: https://docs.modelslab.com/mcp-web-api/agent-cp-tools-reference

Register a new user account with email, password, and name.

```json
{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "agent-auth",
      "arguments": {
        "action": "signup",
        "email": "newuser@example.com",
        "password": "secret123",
        "name": "Agent Runner"
      }
    }
  }
```

--------------------------------

### community.controlnet

Source: https://docs.modelslab.com/sdk/typescript

Guided image generation using reference images.

```APIDOC
## controlnet

### Description
Uses ControlNet models to guide the generation process with reference images.

### Parameters
- **key** (string) - Required - API key
- **prompt** (string) - Required - Generation prompt
- **controlnet_model** (string) - Required - Type of ControlNet (e.g., canny, depth, pose)
- **controlnet_image** (string) - Required - URL of the reference image
- **controlnet_conditioning_scale** (number) - Optional - Scale of the conditioning
```

--------------------------------

### Initialize ModelsLab Client

Source: https://docs.modelslab.com/sdk/golang

Basic client initialization using an API key.

```go
import "github.com/modelslab/modelslab-go/pkg/client"

// Simple client
c := client.New("your-api-key")
```

--------------------------------

### Generate Text-to-Speech with Go SDK

Source: https://docs.modelslab.com/sdk/golang

Initializes the audio client and sends a request to generate speech from a text prompt.

```go
package main

import (
	"context"
	"encoding/json"
	"fmt"

	"github.com/modelslab/modelslab-go/pkg/apis/audio"
	"github.com/modelslab/modelslab-go/pkg/client"
	audioSchema "github.com/modelslab/modelslab-go/pkg/schemas/audio"
)

func main() {
	c := client.New("your-api-key")
	api := audio.New(c, false)

	voice_id := "madison"
	language := "english"
	req := audioSchema.Text2SpeechRequest{
		Prompt:   "a cat sitting on a mat",
		VoiceID:  &voice_id,
		Language: &language,
	}

	resp, err := api.TextToSpeech(context.Background(), &req)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}

	out, _ := json.MarshalIndent(resp, "", "  ")
	fmt.Println(string(out))
}
```

--------------------------------

### Install Modelslab Dependency

Source: https://docs.modelslab.com/sdk/dart

Add the modelslab package to your pubspec.yaml file.

```yaml
dependencies:
  modelslab: ^1.0.0
```

--------------------------------

### client.NewWithConfig

Source: https://docs.modelslab.com/sdk/golang

Initializes a new ModelsLab client with custom configuration settings.

```APIDOC
## client.NewWithConfig(config *client.Config)

### Description
Creates a new instance of the ModelsLab client using a custom configuration object.

### Parameters
- **config** (*client.Config) - Required - Configuration object containing APIKey, BaseURL, FetchRetry, FetchTimeout, and HTTPTimeout.

### Example
```go
config := &client.Config{
	APIKey:       "your-api-key",
	BaseURL:      "https://modelslab.com/api/",
	FetchRetry:   10,
	FetchTimeout: 2 * time.Second,
	HTTPTimeout:  30 * time.Second,
}
c := client.NewWithConfig(config)
```
```

--------------------------------

### MusicGen Request Body

Source: https://docs.modelslab.com/enterprise-api/voice-cloning/music-gen

Example JSON payload for the MusicGen request.

```json
{
  "key":"enterprise_api_key",    
  "prompt":"rock music from the 90s",   
  "init_audio":"https://youtu.be/7Nm6uTHbB-Y?si=ORk1LOQ8J34Z0Lpm",    
  "sampling_rate":32000,    
  "base64":false,
  "temp": false,    
  "webhook":null,    
  "track_id":null
}
```

--------------------------------

### GET /subscriptions/{id}/status

Source: https://docs.modelslab.com/llms.txt

Checks the status of a specific subscription.

```APIDOC
## GET /subscriptions/{id}/status

### Description
Checks the status of a specific subscription.

### Method
GET

### Endpoint
/subscriptions/{id}/status

### Parameters
#### Path Parameters
- **id** (string) - Required - The subscription ID
```

--------------------------------

### List Models via SDKs

Source: https://docs.modelslab.com/llm-api/list-models

Implementation examples for listing models using the OpenAI SDK or standard requests library.

```python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_MODELSLAB_API_KEY",
    base_url="https://modelslab.com/api/v7/llm",
)

models = client.models.list()
for model in models.data:
    print(model.id)
```

```python
import requests

response = requests.get(
    "https://modelslab.com/api/v7/llm/v1/models",
    headers={"x-api-key": "YOUR_MODELSLAB_API_KEY"},
)

models = response.json()
for model in models["data"]:
    print(model["id"])
```

--------------------------------

### community.New

Source: https://docs.modelslab.com/sdk/golang

Initializes a community API instance, optionally enabling enterprise mode.

```APIDOC
## community.New(client, enterpriseMode bool)

### Description
Creates a new community API instance associated with the provided client.

### Parameters
- **client** (interface) - Required - The initialized ModelsLab client.
- **enterpriseMode** (bool) - Required - Set to true to enable enterprise mode.

### Example
```go
communityAPI := community.New(c, true)
```
```

--------------------------------

### GET /payments/{id}/status

Source: https://docs.modelslab.com/llms.txt

Checks the status of a specific payment.

```APIDOC
## GET /payments/{id}/status

### Description
Checks the status of a specific payment.

### Method
GET

### Endpoint
/payments/{id}/status

### Parameters
#### Path Parameters
- **id** (string) - Required - The payment ID
```

--------------------------------

### POST /text-to-video-ultra/system_details

Source: https://docs.modelslab.com/enterprise-api/text-to-video-ultra/system-details

This endpoint returns information about your server by providing a valid enterprise API key.

```APIDOC
## POST /text-to-video-ultra/system_details

### Description
This endpoint returns information about your server.

### Method
POST

### Endpoint
https://modelslab.com/api/v1/enterprise/text-to-video-ultra/system_details

### Request Body
- **key** (string) - Required - Your API key

### Request Example
{
  "key": "enterprise_api_key"
}

### Response
#### Success Response (200)
- **status** (string) - Status of the operation
- **message** (string) - Success message

#### Response Example
{
  "status": "success",
  "message": "Operation completed successfully"
}
```

--------------------------------

### GET /wallet/balance

Source: https://docs.modelslab.com/llms.txt

Performs a quick check of the current wallet balance.

```APIDOC
## GET /wallet/balance

### Description
Performs a quick check of the current wallet balance.

### Method
GET

### Endpoint
/wallet/balance
```

--------------------------------

### POST /nano_banana/system_details

Source: https://docs.modelslab.com/enterprise-api/nano-banana/system-details

Retrieves information about the server, including version, uptime, and GPU usage.

```APIDOC
## POST /nano_banana/system_details

### Description
Returns information about your server.

### Method
POST

### Endpoint
https://modelslab.com/api/v1/enterprise/nano_banana/system_details

### Request Body
- **key** (string) - Required - Your enterprise API key used for request authorization.

### Request Example
{
    "key": "enterprise_api_key"
}

### Response
#### Success Response (200)
- **status** (string) - The status of the request.
- **data** (object) - The server information object.

#### Response Example
{
  "status": "success",
  "data": {
    "server_version": "1.0.0",
    "uptime": "5d 12h 30m",
    "gpu_usage": "45%"
  }
}
```

--------------------------------

### GET /api/v7/llm/v1/models

Source: https://docs.modelslab.com/llm-api/list-models

Retrieves the list of all available LLM models and their capabilities.

```APIDOC
## GET /api/v7/llm/v1/models

### Description
Retrieve the list of all available LLM models and their capabilities.

### Method
GET

### Endpoint
https://modelslab.com/api/v7/llm/v1/models

### Parameters
#### Headers
- **x-api-key** (string) - Required - API key for authentication.

### Request Example
curl https://modelslab.com/api/v7/llm/v1/models \
  -H "x-api-key: $MODELSLAB_API_KEY"

### Response
#### Success Response (200)
- **object** (string) - The type of the object, which is 'list'.
- **data** (array) - A list of model objects.

#### Response Example
{
  "object": "list",
  "data": [
    {
      "id": "Qwen/Qwen2.5-VL-72B-Instruct-together",
      "object": "model",
      "created": 1712345678,
      "owned_by": "Qwen"
    },
    {
      "id": "meta-llama/Llama-3.1-70B-Instruct",
      "object": "model",
      "created": 1712345678,
      "owned_by": "Meta"
    }
  ]
}
```

--------------------------------

### client.New

Source: https://docs.modelslab.com/sdk/golang

Initializes a new ModelsLab client using an API key.

```APIDOC
## client.New(apiKey string)

### Description
Creates a new instance of the ModelsLab client with the provided API key.

### Parameters
- **apiKey** (string) - Required - Your ModelsLab API key.

### Example
```go
c := client.New("your-api-key")
```
```

--------------------------------

### GET /verify/{token}

Source: https://docs.modelslab.com/agents-api/authentication

A compatibility endpoint used for verifying tokens.

```APIDOC
## GET /verify/{token}

### Description
Compatibility verification endpoint.

### Method
GET

### Endpoint
/verify/{token}

### Parameters
#### Path Parameters
- **token** (string) - Required - The verification token.
```

--------------------------------

### GET /api/agents/v1/api-keys/{id}

Source: https://docs.modelslab.com/agents-api/profile-and-api-keys

Retrieves details for a specific API key.

```APIDOC
## GET /api/agents/v1/api-keys/{id}

### Description
Retrieves details for a specific API key.

### Method
GET

### Endpoint
/api/agents/v1/api-keys/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the API key.
```

--------------------------------

### Run Go application

Source: https://docs.modelslab.com/sdk/golang

Execute the main Go file to trigger the API request.

```bash
go run main.go
```

--------------------------------

### GET /api/agents/v1/teams/{id}

Source: https://docs.modelslab.com/agents-api/teams

Retrieve details for a specific team member.

```APIDOC
## GET /api/agents/v1/teams/{id}

### Description
Team member details.

### Method
GET

### Endpoint
/api/agents/v1/teams/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the team member.
```

--------------------------------

### ModelsLab Client Initialization

Source: https://docs.modelslab.com/sdk/php

How to instantiate the ModelsLab client using an API key or custom configuration options.

```APIDOC
## ModelsLab Client Initialization

### Description
Initializes the ModelsLab SDK client. You can provide the API key directly or include custom configuration options such as base URL, retry attempts, and timeout settings.

### Usage
```php
use ModelsLab\ModelsLab;

// Direct API key
$modelslab = new ModelsLab('your-api-key');

// With custom options
$modelslab = new ModelsLab('your-api-key', [
    'base_url' => 'https://modelslab.com/api/',
    'fetch_retry' => 10,
    'fetch_timeout' => 2
]);
```
```
Tokens:
Raw