LinkModel API Documentation

POST

chat

completions

OpenAI Chat Completions

curl --request POST \
  --url https://api.linkmodel.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "claude-opus-4-5-20251101",
  "messages": [
    {
      "role": "user",
      "content": "Hello, who are you?"
    }
  ],
  "stream": false,
  "max_tokens": 1024,
  "max_completion_tokens": 1024,
  "temperature": 1,
  "top_p": 0.95,
  "frequency_penalty": 0,
  "presence_penalty": 0,
  "stop": [
    "<string>"
  ],
  "tools": [
    {}
  ],
  "response_format": {},
  "reasoning": {}
}
'

import requests

url = "https://api.linkmodel.ai/v1/chat/completions"

payload = {
    "model": "claude-opus-4-5-20251101",
    "messages": [
        {
            "role": "user",
            "content": "Hello, who are you?"
        }
    ],
    "stream": False,
    "max_tokens": 1024,
    "max_completion_tokens": 1024,
    "temperature": 1,
    "top_p": 0.95,
    "frequency_penalty": 0,
    "presence_penalty": 0,
    "stop": ["<string>"],
    "tools": [{}],
    "response_format": {},
    "reasoning": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'claude-opus-4-5-20251101',
    messages: [{role: 'user', content: 'Hello, who are you?'}],
    stream: false,
    max_tokens: 1024,
    max_completion_tokens: 1024,
    temperature: 1,
    top_p: 0.95,
    frequency_penalty: 0,
    presence_penalty: 0,
    stop: ['<string>'],
    tools: [{}],
    response_format: {},
    reasoning: {}
  })
};

fetch('https://api.linkmodel.ai/v1/chat/completions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkmodel.ai/v1/chat/completions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'claude-opus-4-5-20251101',
    'messages' => [
        [
                'role' => 'user',
                'content' => 'Hello, who are you?'
        ]
    ],
    'stream' => false,
    'max_tokens' => 1024,
    'max_completion_tokens' => 1024,
    'temperature' => 1,
    'top_p' => 0.95,
    'frequency_penalty' => 0,
    'presence_penalty' => 0,
    'stop' => [
        '<string>'
    ],
    'tools' => [
        [
                
        ]
    ],
    'response_format' => [
        
    ],
    'reasoning' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkmodel.ai/v1/chat/completions"

	payload := strings.NewReader("{\n  \"model\": \"claude-opus-4-5-20251101\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello, who are you?\"\n    }\n  ],\n  \"stream\": false,\n  \"max_tokens\": 1024,\n  \"max_completion_tokens\": 1024,\n  \"temperature\": 1,\n  \"top_p\": 0.95,\n  \"frequency_penalty\": 0,\n  \"presence_penalty\": 0,\n  \"stop\": [\n    \"<string>\"\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"response_format\": {},\n  \"reasoning\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkmodel.ai/v1/chat/completions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"claude-opus-4-5-20251101\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello, who are you?\"\n    }\n  ],\n  \"stream\": false,\n  \"max_tokens\": 1024,\n  \"max_completion_tokens\": 1024,\n  \"temperature\": 1,\n  \"top_p\": 0.95,\n  \"frequency_penalty\": 0,\n  \"presence_penalty\": 0,\n  \"stop\": [\n    \"<string>\"\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"response_format\": {},\n  \"reasoning\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkmodel.ai/v1/chat/completions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"claude-opus-4-5-20251101\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello, who are you?\"\n    }\n  ],\n  \"stream\": false,\n  \"max_tokens\": 1024,\n  \"max_completion_tokens\": 1024,\n  \"temperature\": 1,\n  \"top_p\": 0.95,\n  \"frequency_penalty\": 0,\n  \"presence_penalty\": 0,\n  \"stop\": [\n    \"<string>\"\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"response_format\": {},\n  \"reasoning\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1716000000,
  "model": "claude-opus-4-7",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "I'm an AI assistant. How can I help you today?",
        "tool_calls": [
          {}
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 18,
    "total_tokens": 30
  }
}

{
  "code": 400,
  "msg": "model is required",
  "request_id": "96be7a7d-3e81-4916-a6b8-19b32773a693"
}

{
  "code": 401,
  "msg": "invalid api key",
  "request_id": "bff4c295-c7da-4507-9708-4627cb6373ba"
}

{
  "code": 500,
  "msg": "chat completion failed: billing: code=100601: insufficient balance",
  "request_id": "3409f6fb-fa9a-4534-b530-195b5f6f4e32"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

model

string

required

ID of the chat model to use. See Models for the current model list, pricing, and endpoint support.

Example:

"claude-opus-4-5-20251101"

messages

object[]

required

The conversation so far, as an ordered list of messages.

Show child attributes

stream

boolean

default:false

If true, partial deltas are streamed as Server-Sent Events.

max_tokens

integer

Maximum number of tokens to generate in the completion.

Example:

1024

max_completion_tokens

integer

OpenAI-compatible alias for maximum generated tokens.

Example:

1024

temperature

number

Sampling temperature. Higher values produce more random output.

Required range: 0 <= x <= 2

Example:

1

top_p

number

Nucleus sampling parameter.

Required range: 0 <= x <= 1

Example:

0.95

frequency_penalty

number

Penalizes repeated tokens.

Required range: -2 <= x <= 2

Example:

0

presence_penalty

number

Penalizes tokens based on whether they already appeared.

Required range: -2 <= x <= 2

Example:

0

stop

string[]

Up to 4 sequences where the API stops generating further tokens. The generated text will not contain the stop sequence.

tools

object[]

Optional tool definitions in the OpenAI Chat Completions format. Support can vary by selected model and provider.

tool_choice

Controls which tool the model may call. Support can vary by selected model and provider.

Available options:

auto,

none,

required

response_format

object

Optional structured-output format, such as { "type": "json_object" } or JSON schema. Support can vary by selected model and provider.

reasoning

object

Optional reasoning controls for models that expose reasoning behavior. Support can vary by selected model and provider.

Response

Chat completion result. When stream is true, the body is an SSE stream instead.

string

Example:

"chatcmpl-abc123"

object

string

Example:

"chat.completion"

created

integer

Unix timestamp (seconds) of when the completion was created.

Example:

1716000000

model

string

Example:

"claude-opus-4-7"

choices

object[]

Show child attributes

usage

object

Show child attributes

OpenAI Chat Completions

curl --request POST \
  --url https://api.linkmodel.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "claude-opus-4-5-20251101",
  "messages": [
    {
      "role": "user",
      "content": "Hello, who are you?"
    }
  ],
  "stream": false,
  "max_tokens": 1024,
  "max_completion_tokens": 1024,
  "temperature": 1,
  "top_p": 0.95,
  "frequency_penalty": 0,
  "presence_penalty": 0,
  "stop": [
    "<string>"
  ],
  "tools": [
    {}
  ],
  "response_format": {},
  "reasoning": {}
}
'

import requests

url = "https://api.linkmodel.ai/v1/chat/completions"

payload = {
    "model": "claude-opus-4-5-20251101",
    "messages": [
        {
            "role": "user",
            "content": "Hello, who are you?"
        }
    ],
    "stream": False,
    "max_tokens": 1024,
    "max_completion_tokens": 1024,
    "temperature": 1,
    "top_p": 0.95,
    "frequency_penalty": 0,
    "presence_penalty": 0,
    "stop": ["<string>"],
    "tools": [{}],
    "response_format": {},
    "reasoning": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'claude-opus-4-5-20251101',
    messages: [{role: 'user', content: 'Hello, who are you?'}],
    stream: false,
    max_tokens: 1024,
    max_completion_tokens: 1024,
    temperature: 1,
    top_p: 0.95,
    frequency_penalty: 0,
    presence_penalty: 0,
    stop: ['<string>'],
    tools: [{}],
    response_format: {},
    reasoning: {}
  })
};

fetch('https://api.linkmodel.ai/v1/chat/completions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkmodel.ai/v1/chat/completions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'claude-opus-4-5-20251101',
    'messages' => [
        [
                'role' => 'user',
                'content' => 'Hello, who are you?'
        ]
    ],
    'stream' => false,
    'max_tokens' => 1024,
    'max_completion_tokens' => 1024,
    'temperature' => 1,
    'top_p' => 0.95,
    'frequency_penalty' => 0,
    'presence_penalty' => 0,
    'stop' => [
        '<string>'
    ],
    'tools' => [
        [
                
        ]
    ],
    'response_format' => [
        
    ],
    'reasoning' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkmodel.ai/v1/chat/completions"

	payload := strings.NewReader("{\n  \"model\": \"claude-opus-4-5-20251101\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello, who are you?\"\n    }\n  ],\n  \"stream\": false,\n  \"max_tokens\": 1024,\n  \"max_completion_tokens\": 1024,\n  \"temperature\": 1,\n  \"top_p\": 0.95,\n  \"frequency_penalty\": 0,\n  \"presence_penalty\": 0,\n  \"stop\": [\n    \"<string>\"\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"response_format\": {},\n  \"reasoning\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkmodel.ai/v1/chat/completions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"claude-opus-4-5-20251101\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello, who are you?\"\n    }\n  ],\n  \"stream\": false,\n  \"max_tokens\": 1024,\n  \"max_completion_tokens\": 1024,\n  \"temperature\": 1,\n  \"top_p\": 0.95,\n  \"frequency_penalty\": 0,\n  \"presence_penalty\": 0,\n  \"stop\": [\n    \"<string>\"\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"response_format\": {},\n  \"reasoning\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkmodel.ai/v1/chat/completions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"claude-opus-4-5-20251101\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Hello, who are you?\"\n    }\n  ],\n  \"stream\": false,\n  \"max_tokens\": 1024,\n  \"max_completion_tokens\": 1024,\n  \"temperature\": 1,\n  \"top_p\": 0.95,\n  \"frequency_penalty\": 0,\n  \"presence_penalty\": 0,\n  \"stop\": [\n    \"<string>\"\n  ],\n  \"tools\": [\n    {}\n  ],\n  \"response_format\": {},\n  \"reasoning\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1716000000,
  "model": "claude-opus-4-7",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "I'm an AI assistant. How can I help you today?",
        "tool_calls": [
          {}
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 18,
    "total_tokens": 30
  }
}

{
  "code": 400,
  "msg": "model is required",
  "request_id": "96be7a7d-3e81-4916-a6b8-19b32773a693"
}

{
  "code": 401,
  "msg": "invalid api key",
  "request_id": "bff4c295-c7da-4507-9708-4627cb6373ba"
}

{
  "code": 500,
  "msg": "chat completion failed: billing: code=100601: insufficient balance",
  "request_id": "3409f6fb-fa9a-4534-b530-195b5f6f4e32"
}

Image Generation

Video Generation

Chat

OpenAI Chat Completions

Authorizations

Body

Response