Takardun API na Shannon AI

Dubawa

Dokokin jama'a

Duk abin da kuke buƙata don jigilar kaya tare da Shannon's OpenAI da API masu jituwa na Anthropic.

Tushen URL BuɗeAI-Masu jituwa

https://api.shannon-ai.com/v1/chat/completions

Yi amfani da API ɗin Taɗi tare da kiran aiki da yawo.

Tushen URL Anthropic-Masu jituwa

https://api.shannon-ai.com/v1/messages

Tsarin Saƙonnin Claude tare da kayan aiki da taken nau'in ɗan adam.

Shugabanni Tabbatarwa

Izini: Mai ɗauka <key-key>

Ko X-API-Key tare da sigar ɗan adam don kiran salon Claude.

Shiga Matsayi

Dokokin jama'a - Maɓallin da ake buƙata don kira

Yawo, kiran aiki, tsararrun abubuwan samarwa, binciken yanar gizo.

Kaddamar da jerin abubuwan dubawa

+

Nuna SDK ɗinku a Shannon

Saita tusheURL zuwa OpenAI ko Anthropic ƙarshen maki a sama.

Saita
+

Haɗa maɓallin API ɗin ku

Yi amfani da alamun Bearer don kiran OpenAI ko X-API-Key + sigar ɗan adam.

Tsaro
+

Kunna kayan aikin & abubuwan da aka tsara

Yana goyan bayan kayan aikin / ayyuka na OpenAI, tsarin JSON, da ginanniyar binciken gidan yanar gizo.

Abubuwan iyawa
+

Bibiyar amfani

Duba alamar alama da yawan bincike akan wannan shafin lokacin shiga cikin asusun ku.

Bincike

Abubuwan iyawa

OpenAI + Anthropic

Sauyawa zuwa ga OpenAI da APIs na Anthropic tare da goyan bayan ƙasa don kayan aiki, abubuwan da aka tsara, da ginanniyar binciken gidan yanar gizo.

Sauya Sauyawa

Mai jituwa

Yana aiki tare da OpenAI da SDKs Anthropic. Kawai canza tushen URL.

Kiran Aiki

Kayan aiki

Ƙayyade kayan aikin, bari Shannon ta kira su. Yana goyan bayan atomatik, tilastawa, kuma babu kowane yanayi.

Binciken Yanar Gizon da aka Gina

Bincika

Binciken gidan yanar gizo na ainihi tare da ambaton tushe. Akwai ta atomatik.

Abubuwan da aka Tsara

JSON

Yanayin JSON da JSON Tsare-tsare Tsare-tsare don amintaccen hakar bayanai.

Kayan aikin juyawa da yawa

Wakili

Madaukakan aiwatar da ayyuka ta atomatik. Har zuwa maimaitawa 10 a kowace buƙata.

Yawo

Mai sauri

Abubuwan da aka aika uwar garken don yawo na token na ainihi.

Saurin Farawa

Minti 5

Fara a matakai uku. Shannon madubi OpenAI da Anthropic abokan ciniki.

Saita tushe URL

Yi amfani da madaidaicin ƙarshen ƙarshen OpenAI.

https://api.shannon-ai.com/v1/chat/completions

Ƙara maɓallin API ɗin ku

Yi amfani da auth mai ɗaukar hoto a cikin taken izini.

Aika sakon ku na farko

Zaɓi harshe kuma musanya cikin maɓallin ku.

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/v1"
)

response = client.chat.completions.create(
    model="shannon-1.6-lite",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, Shannon!"}
    ],
    max_tokens=1024
)

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

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

const response = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  messages: [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'Hello, Shannon!' }
  ],
  max_tokens: 1024
});

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

package main

import (
    "context"
    "fmt"
    openai "github.com/sashabaranov/go-openai"
)

func main() {
    config := openai.DefaultConfig("YOUR_API_KEY")
    config.BaseURL = "https://api.shannon-ai.com/v1"
    client := openai.NewClientWithConfig(config)

    resp, err := client.CreateChatCompletion(
        context.Background(),
        openai.ChatCompletionRequest{
            Model: "shannon-1.6-lite",
            Messages: []openai.ChatCompletionMessage{
                {Role: "system", Content: "You are a helpful assistant."},
                {Role: "user", Content: "Hello, Shannon!"},
            },
            MaxTokens: 1024,
        },
    )
    if err != nil {
        panic(err)
    }
    fmt.Println(resp.Choices[0].Message.Content)
}

cURL

curl -X POST "https://api.shannon-ai.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shannon-1.6-lite",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello, Shannon!"}
    ],
    "max_tokens": 1024
  }'

Tsarin amsawa

Amsa Nasara

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "Shannon 1.6 Lite",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! I'm Shannon, your AI assistant. How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 18,
    "total_tokens": 43
  }
}

Filin Wasan API

Sabo

Gwada Shannon API kai tsaye a cikin burauzar ku. Gina buƙatun ku, gudanar da shi, kuma duba martanin a ainihin-lokaci.

Chat, Responses, Messages

Switch across OpenAI Chat Completions, Responses, and Anthropic Messages without leaving the playground.

Stream live output

Run real requests, inspect raw JSON, and view stream events from the same operator console.

Reuse your key

Signed-in users can pull their Shannon API key straight into the dedicated playground workspace.

/ha/docs/playground

The playground now lives on its own route so the API docs stay Astro-rendered while the request builder remains an explicitly interactive client tool.

Gwada filin wasa V2 Samu Maɓallin API ɗinku

Tabbatarwa

Duk buƙatun API na buƙatar tabbaci ta amfani da maɓallin API na Shannon.

BudeAI Tsarin (An Shawarta)

HTTP

Authorization: Bearer YOUR_API_KEY

Tsarin Anthropic

HTTP

X-API-Key: YOUR_API_KEY
anthropic-version: 2023-06-01

Samfura

Shannon yana ba da samfura da yawa waɗanda aka inganta don lokuta daban-daban na amfani.

shannon-1.6-lite Shannon 1.6 Lite

Amsoshi masu sauri, masu inganci don ayyukan yau da kullun

Magana 128K

Mafi kyawun Ga Taɗi, Q&A, Ƙarfafa Abun ciki

shannon-1.6-pro Shannon 1.6 Pro

Babban dalili don matsaloli masu rikitarwa

Magana 128K

Mafi kyawun Ga Nazari, Bincike, Hadaddiyar Ayyuka

shannon-2-lite Shannon 2 Lite

Magana 128K

Mafi kyawun Ga

shannon-2-pro Shannon 2 Pro

Magana 128K

Mafi kyawun Ga

shannon-coder-1 Shannon Coder

An inganta don Claude Code CLI tare da adadin tushen kira

Magana 128K

Mafi kyawun Ga Ƙirƙirar Code, Amfani da Kayan aiki, Haɗin CLI

Ƙididdigar tushen kira

Kiran Aiki

Ƙayyade kayan aikin da Shannon zai iya kira don aiwatar da ayyuka ko dawo da bayanai.

Python

from openai import OpenAI
import json

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/v1"
)

# Define available tools/functions
tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get current weather for a location",
            "parameters": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "City name, e.g., 'Tokyo'"
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"]
                    }
                },
                "required": ["location"]
            }
        }
    }
]

response = client.chat.completions.create(
    model="shannon-1.6-lite",
    messages=[{"role": "user", "content": "What's the weather in Tokyo?"}],
    tools=tools,
    tool_choice="auto"
)

# Check if model wants to call a function
if response.choices[0].message.tool_calls:
    tool_call = response.choices[0].message.tool_calls[0]
    print(f"Function: {tool_call.function.name}")
    print(f"Arguments: {tool_call.function.arguments}")

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

const tools = [
  {
    type: 'function',
    function: {
      name: 'get_weather',
      description: 'Get current weather for a location',
      parameters: {
        type: 'object',
        properties: {
          location: { type: 'string', description: "City name" },
          unit: { type: 'string', enum: ['celsius', 'fahrenheit'] }
        },
        required: ['location']
      }
    }
  }
];

const response = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  messages: [{ role: 'user', content: "What's the weather in Tokyo?" }],
  tools,
  tool_choice: 'auto'
});

if (response.choices[0].message.tool_calls) {
  const toolCall = response.choices[0].message.tool_calls[0];
  console.log('Function:', toolCall.function.name);
  console.log('Arguments:', toolCall.function.arguments);
}

Zaɓuɓɓukan Zaɓin Kayan aiki

"auto" Model yana yanke shawarar ko za a kira aiki (tsoho)

"none" Kashe kiran aikin don wannan buƙatar

{"type": "function", "function": {"name": "..."}} Tilasta takamaiman kiran aiki

Amsa Kiran Aiki

Lokacin da samfurin ya kira aiki

{
  "id": "chatcmpl-xyz",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": null,
        "tool_calls": [
          {
            "id": "call_abc123",
            "type": "function",
            "function": {
              "name": "get_weather",
              "arguments": "{\"location\": \"Tokyo\", \"unit\": \"celsius\"}"
            }
          }
        ]
      },
      "finish_reason": "tool_calls"
    }
  ]
}

Abubuwan da aka Tsara

Tilasta Shannon don amsawa da ingantaccen JSON wanda yayi daidai da tsarin ku.

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/v1"
)

# Force JSON output with schema
response = client.chat.completions.create(
    model="shannon-1.6-lite",
    messages=[
        {"role": "user", "content": "Extract: John Doe, 30 years old, engineer"}
    ],
    response_format={
        "type": "json_schema",
        "json_schema": {
            "name": "person_info",
            "schema": {
                "type": "object",
                "properties": {
                    "name": {"type": "string"},
                    "age": {"type": "integer"},
                    "occupation": {"type": "string"}
                },
                "required": ["name", "age", "occupation"]
            }
        }
    }
)

import json
data = json.loads(response.choices[0].message.content)
print(data)  # {"name": "John Doe", "age": 30, "occupation": "engineer"}

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

const response = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  messages: [
    { role: 'user', content: 'Extract: John Doe, 30 years old, engineer' }
  ],
  response_format: {
    type: 'json_schema',
    json_schema: {
      name: 'person_info',
      schema: {
        type: 'object',
        properties: {
          name: { type: 'string' },
          age: { type: 'integer' },
          occupation: { type: 'string' }
        },
        required: ['name', 'age', 'occupation']
      }
    }
  }
});

const data = JSON.parse(response.choices[0].message.content);
console.log(data); // { name: "John Doe", age: 30, occupation: "engineer" }

Zaɓuɓɓukan Tsarin Amsa

{"type": "json_object"} Tilasta ingantaccen fitarwa JSON (babu takamaiman tsari)

{"type": "json_schema", "json_schema": {...}} Tilasta fitarwa da ya dace da ainihin tsarin ku

Yawo

Kunna yawo na ainihin-lokaci tare da Abubuwan da aka aiko da Sabar don UIs masu amsawa.

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/v1"
)

# Enable streaming for real-time responses
stream = client.chat.completions.create(
    model="shannon-1.6-lite",
    messages=[
        {"role": "user", "content": "Write a short poem about AI"}
    ],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

// Enable streaming for real-time responses
const stream = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  messages: [
    { role: 'user', content: 'Write a short poem about AI' }
  ],
  stream: true
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) process.stdout.write(content);
}

Tukwici: Amsoshi masu yawo suna zuwa azaman abubuwan da aka aiko da Sabar. Kowane gungu yana ƙunshe da delta tare da ɓangaren abun ciki.

Binciken Yanar Gizon da aka Gina

Shannon ya ƙunshi ginannen aikin gidan yanar gizo_search wanda ke samuwa ta atomatik.

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/v1"
)

# Web search is automatically available!
# Shannon will use it when needed for current information

response = client.chat.completions.create(
    model="shannon-1.6-lite",
    messages=[
        {"role": "user", "content": "What are the latest AI news today?"}
    ],
    # Optionally, explicitly define web_search tool
    tools=[{
        "type": "function",
        "function": {
            "name": "web_search",
            "description": "Search the web for current information",
            "parameters": {
                "type": "object",
                "properties": {
                    "query": {"type": "string", "description": "Search query"}
                },
                "required": ["query"]
            }
        }
    }]
)

print(response.choices[0].message.content)
# Response includes sources and citations

JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/v1'
});

// Web search is automatically available!
// Shannon will use it when needed for current information

const response = await client.chat.completions.create({
  model: 'shannon-1.6-lite',
  messages: [
    { role: 'user', content: 'What are the latest AI news today?' }
  ],
  // Optionally, explicitly define web_search tool
  tools: [{
    type: 'function',
    function: {
      name: 'web_search',
      description: 'Search the web for current information',
      parameters: {
        type: 'object',
        properties: {
          query: { type: 'string', description: 'Search query' }
        },
        required: ['query']
      }
    }
  }]
});

console.log(response.choices[0].message.content);
// Response includes sources and citations

Pro Tukwici: Sakamakon binciken yanar gizo ya haɗa da ambato. Shannon zai buga tushe ta atomatik.

Tsarin Anthropic

Shannon kuma yana goyan bayan tsarin API na Saƙonnin Anthropic.

https://api.shannon-ai.com/v1/messages

Python

import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.shannon-ai.com/messages"
)

response = client.messages.create(
    model="shannon-1.6-lite",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Shannon!"}
    ],
    # Tool use (Anthropic format)
    tools=[{
        "name": "web_search",
        "description": "Search the web",
        "input_schema": {
            "type": "object",
            "properties": {
                "query": {"type": "string"}
            },
            "required": ["query"]
        }
    }]
)

print(response.content[0].text)

JavaScript

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.shannon-ai.com/messages'
});

const response = await client.messages.create({
  model: 'shannon-1.6-lite',
  max_tokens: 1024,
  messages: [
    { role: 'user', content: 'Hello, Shannon!' }
  ],
  // Tool use (Anthropic format)
  tools: [{
    name: 'web_search',
    description: 'Search the web',
    input_schema: {
      type: 'object',
      properties: {
        query: { type: 'string' }
      },
      required: ['query']
    }
  }]
});

console.log(response.content[0].text);

Taken da ake buƙata: Tsarin Anthropic yana buƙatar sigar ɗan adam: 2023-06-01.

SDKs

Mai jituwa

Yi amfani da kowane OpenAI ko Anthropic SDK - kawai canza tushen URL.

BuɗeAI-Masu jituwa SDKs

SDK Python

OpenAI Python SDK na hukuma - yana aiki tare da Shannon

pip install openai

Duba Docs ->

SDK JavaScript / TypeScript

OpenAI Node.js SDK na hukuma - yana aiki tare da Shannon

npm install openai

Duba Docs ->

SDK Go

Community Go abokin ciniki don APIs masu jituwa na OpenAI

go get github.com/sashabaranov/go-openai

Duba Docs ->

SDK Ruby

Abokin ciniki na Ruby na Community don APIs masu jituwa na OpenAI

gem install ruby-openai

Duba Docs ->

SDK PHP

Abokin ciniki na jama'a na PHP don APIs masu jituwa na OpenAI

composer require openai-php/client

Duba Docs ->

SDK Rust

Abokin ciniki na Async Rust don APIs masu jituwa na OpenAI

cargo add async-openai

Duba Docs ->

SDKs masu dacewa da ɗan adam

SDK Python (Anthropic)

Official Anthropic Python SDK - yana aiki tare da Shannon

pip install anthropic

Duba Docs ->

SDK TypeScript (Anthropic)

Official Anthropic TypeScript SDK - yana aiki tare da Shannon

npm install @anthropic-ai/sdk

Duba Docs ->

Kuskuren Gudanarwa

Shannon yana amfani da daidaitattun lambobin matsayin HTTP kuma yana dawo da cikakkun saƙonnin kuskure.

400 Bukatar Mummuna Tsarin buƙatun mara inganci ko sigogi

401 Ba tare da izini ba Maɓallin API mara inganci ko ya ɓace

402 Ƙidaya ta wuce Alamu ko adadin bincike ya wuce

429 Rate Limited Bukatu da yawa, rage gudu

500 Kuskuren uwar garken Kuskuren ciki, sake gwadawa daga baya

Tsarin Amsa Kuskure

Martanin Kuskure

{
  "error": {
    "message": "Invalid API key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Canji

LOG

Sabunta kwanan nan da haɓakawa ga Shannon API.

v2.1.0

2025-01-03

Sabo Ƙara samfurin shannon-coder-1 don haɗakar Claude Code CLI
Sabo Tsarin ƙididdiga na tushen kira don ƙirar Coder
Inganta Inganta amincin kiran aikin

v2.0.0

2024-12-15

Sabo Haɓakar API ɗin Saƙonnin Anthropic
Sabo Kisa kayan aiki da yawa (har zuwa 10)
Sabo Tallafin tsarin amsawar tsari na JSON
Inganta Ingantattun binciken yanar gizo tare da mafi kyawun ambato

v1.5.0

2024-11-20

Sabo Ƙara samfurin shannon-zurfi-dapo don hadadden tunani
Sabo Ginin aikin gidan yanar gizo_search
Inganta Rage jinkiri don martanin yawo

v1.0.0

2024-10-01

Sabo Sakin API na farko
Sabo BudeAI mai dacewa da taɗi ya ƙare ƙarshen ƙarshen
Sabo Tallafin kiran aiki
Sabo Yawo ta hanyar Abubuwan Da Aka Aiko na Sabar

Maɓallin API ɗinku

Shiga

Yi amfani da alamun Bearer don kiran OpenAI ko X-API-Key + sigar ɗan adam.

YOUR_API_KEY

Samu Maɓallin API ɗinku

Kiyaye sirrin maɓallin API ɗin ku. Sake haɓakawa yana ƙirƙirar sabon maɓalli kuma yana lalata tsohuwar.

Amfanin ku

Duba alamar alama da yawan bincike akan wannan shafin lokacin shiga cikin asusun ku.

-- API Kiran

-- Alamomin Amfani

API ɗin Shannon

Dubawa

Abubuwan iyawa

Sauya Sauyawa

Kiran Aiki

Binciken Yanar Gizon da aka Gina

Abubuwan da aka Tsara

Kayan aikin juyawa da yawa

Yawo

Saurin Farawa

Saita tushe URL

Ƙara maɓallin API ɗin ku

Aika sakon ku na farko

Tsarin amsawa

Filin Wasan API

Chat, Responses, Messages

Stream live output

Reuse your key

Tabbatarwa

BudeAI Tsarin (An Shawarta)

Tsarin Anthropic

Samfura

Kiran Aiki

Zaɓuɓɓukan Zaɓin Kayan aiki

Amsa Kiran Aiki

Abubuwan da aka Tsara

Zaɓuɓɓukan Tsarin Amsa

Yawo

Binciken Yanar Gizon da aka Gina

Tsarin Anthropic

SDKs

BuɗeAI-Masu jituwa SDKs

SDKs masu dacewa da ɗan adam

Kuskuren Gudanarwa

Tsarin Amsa Kuskure

Canji

Maɓallin API ɗinku

Amfanin ku

Shannon Coder (shannon-coder-1)

Shirye don Gina?

Shannon AI API Documentation

Dubawa

Abubuwan iyawa

Sauya Sauyawa

Kiran Aiki

Binciken Yanar Gizon da aka Gina

Abubuwan da aka Tsara

Kayan aikin juyawa da yawa

Yawo

Saurin Farawa

Saita tushe URL

Ƙara maɓallin API ɗin ku

Aika sakon ku na farko

Tsarin amsawa

Filin Wasan API

Chat, Responses, Messages

Stream live output

Reuse your key

Tabbatarwa

BudeAI Tsarin (An Shawarta)

Tsarin Anthropic

Samfura

Kiran Aiki

Zaɓuɓɓukan Zaɓin Kayan aiki

Amsa Kiran Aiki

Abubuwan da aka Tsara

Zaɓuɓɓukan Tsarin Amsa

Yawo

Binciken Yanar Gizon da aka Gina

Tsarin Anthropic

SDKs

BuɗeAI-Masu jituwa SDKs

SDKs masu dacewa da ɗan adam

Kuskuren Gudanarwa

Tsarin Amsa Kuskure

Canji

Maɓallin API ɗinku

Amfanin ku

Shannon Coder (shannon-coder-1)

Shirye don Gina?