Samurai AI Documentation

{
  "model": "anthropic/claude-3.7-sonnet",
  "messages": [
    {
      "role": "user",
      "content": "Hello, how are you?"
    }
  ],
  "max_tokens": 1024,
  "temperature": 0.7,
  "stream": false
}

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "anthropic/claude-3.7-sonnet",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! I'm doing well, thank you for asking."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 12,
    "total_tokens": 22
  }
}

{
  "model": "anthropic/claude-3.7-sonnet",
  "messages": [
    {"role": "user", "content": "Write a story"}
  ],
  "stream": true
}

data: {"choices":[{"delta":{"content":"Hello"},"index":0}]}

data: {"choices":[{"delta":{"content":" world"},"index":0}]}

data: [DONE]

{
  "model": "flux-pro-1.1-ultra",
  "prompt": "A serene Japanese garden with cherry blossoms",
  "n": 1,
  "size": "1024x1024",
  "quality": "standard"
}

{
  "created": 1677652288,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "b64_json": null
    }
  ]
}

curl https://samuraiapi.in/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "flux-pro-1.1-ultra",
    "prompt": "A serene Japanese garden with cherry blossoms",
    "n": 1,
    "size": "1024x1024"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://samuraiapi.in/v1"
)

response = client.images.generate(
    model="flux-pro-1.1-ultra",
    prompt="A serene Japanese garden with cherry blossoms",
    n=1,
    size="1024x1024"
)

print(response.data[0].url)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://samuraiapi.in/v1'
});

const response = await client.images.generate({
  model: 'flux-pro-1.1-ultra',
  prompt: 'A serene Japanese garden with cherry blossoms',
  n: 1,
  size: '1024x1024'
});

console.log(response.data[0].url);

curl https://samuraiapi.in/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F image="@original.png" \
  -F prompt="Add a sunset in the background" \
  -F n=1 \
  -F size="1024x1024"

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://samuraiapi.in/v1"
)

response = client.images.edit(
    image=open("original.png", "rb"),
    prompt="Add a sunset in the background",
    n=1,
    size="1024x1024"
)

print(response.data[0].url)

{
  "model": "sora-2",
  "prompt": "A young man walking on the street at sunset",
  "duration": 5
}

{
  "created": 1677652288,
  "data": [
    {
      "url": "https://example.com/generated-video.mp4"
    }
  ]
}

curl https://samuraiapi.in/v1/videos \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "sora-2",
    "prompt": "A young man walking on the street at sunset",
    "duration": 5
  }'

import requests

response = requests.post(
    "https://samuraiapi.in/v1/videos",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "sora-2",
        "prompt": "A young man walking on the street at sunset",
        "duration": 5
    }
)

video_url = response.json()["data"][0]["url"]
print(video_url)

curl https://samuraiapi.in/v1/images/to-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F model="sora-2-i2v" \
  -F image="@cat.png" \
  -F prompt="The cat starts to dance" \
  -F duration=5

import requests

with open("cat.png", "rb") as image_file:
    response = requests.post(
        "https://samuraiapi.in/v1/images/to-video",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        files={"image": image_file},
        data={
            "model": "sora-2-i2v",
            "prompt": "The cat starts to dance",
            "duration": 5
        }
    )

video_url = response.json()["data"][0]["url"]
print(video_url)

import fs from 'fs';
import FormData from 'form-data';

const formData = new FormData();
formData.append('model', 'sora-2-i2v');
formData.append('image', fs.createReadStream('cat.png'));
formData.append('prompt', 'The cat starts to dance');
formData.append('duration', '5');

const response = await fetch('https://samuraiapi.in/v1/images/to-video', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    ...formData.getHeaders()
  },
  body: formData
});

const data = await response.json();
console.log(data.data[0].url);

from openai import OpenAI

client = OpenAI(
    api_key="your_samurai_api_key",
    base_url="https://samuraiapi.in/v1"
)

response = client.chat.completions.create(
    model="anthropic/claude-3.7-sonnet",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

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

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.SAMURAI_API_KEY,
  baseURL: 'https://samuraiapi.in/v1',
});

const response = await client.chat.completions.create({
  model: 'anthropic/claude-3.7-sonnet',
  messages: [
    { role: 'user', content: 'Hello!' }
  ],
});

console.log(response.choices[0].message.content);

from openai import OpenAI
import httpx

client = OpenAI(
    api_key="your_samurai_api_key",
    base_url="https://samuraiapi.in/v1",
    timeout=httpx.Timeout(60.0, connect=10.0),
    max_retries=3
)

try:
    response = client.chat.completions.create(
        model="anthropic/claude-3.7-sonnet",
        messages=[{"role": "user", "content": "Hello!"}]
    )
except httpx.TimeoutException:
    print("Request timed out")
except Exception as e:
    print(f"Error: {e}")