Arendaja platvorm

SenseNova API

SenseTime ülevaade arendajatele, mis hõlmab API-juurdepääsu, hinnastust, SDK-tuge, lõppunkte, võimekusi ja platvormi reegleid.

Dokumentatsioon API juhend

API võti Nõutud

Peamine API SenseNova Token Plan API koos OpenAI-ga ühilduvate pildi-API lõpp-punktide ja SenseNova vestlus-API-dega

SDK tugi Toetatud on otse HTTPS-päringud ja OpenAI-ga ühilduvad kliendid. Token Plan API ametliku ajakohase Python-, JavaScripti- või PHP SDK paketi olemasolu ei õnnestunud usaldusväärselt kinnitada.

Päringupiirangud Praeguse avaliku beetaversiooni teadaandes on SenseNova U1.5 Lite’i puhul märgitud piiranguks 1500 päringut iga viie tunni järel. Laiemaid konto-, mudeli- ja tootmiskeskkonna päringupiiranguid ei õnnestunud usaldusväärselt kontrollida.

Platvorm

API ülevaade

Lõppunktid (endpoints)

API ligipääs

Juuraadress (Base URL)


					https://token.sensenova.cn/v1

Peamine API SenseNova Token Plan API koos OpenAI-ga ühilduvate pildi-API lõpp-punktide ja SenseNova vestlus-API-dega

Hinnad

API Hinnad

Hinnakujundusmudel Kasutus- ja kvoodipõhine API-hinnastus; valitud mudelitele võivad kehtida avaliku beetaversiooni kvoodid

SenseNova U1.5 Lite’il on praegu dokumenteeritud tasuta avaliku beetaversiooni limiit: 1500 päringut iga viie tunni järel. Mudeli üldist kommertshinda ei õnnestunud ligipääsetavatel ametlikel lehtedel usaldusväärselt kontrollida.

Arendaja töömugavus

SDK info

SDK Toetatud on otse HTTPS-päringud ja OpenAI-ga ühilduvad kliendid. Token Plan API ametliku ajakohase Python-, JavaScripti- või PHP SDK paketi olemasolu ei õnnestunud usaldusväärselt kinnitada.

Kasutusmugavus Mõõdukas; REST-i ja OpenAI-ga ühilduvad kasutusmustrid on tuttavad, kuid lõpp-punktide versioonid ja mudelipõhine dokumentatsioon nõuavad hoolikat kontrollimist.

Dokumentatsioon Mõõdukas; ametlik API lõpp-punktide dokumentatsioon on saadaval, kuid suur osa põhjalikust lähtematerjalist on hiinakeelne ning avalik ingliskeelne käsitlus on puudulik.

Allikad

Viited arendajale

Dokumentatsioon ↗ API juhend ↗ Liivakast ↗

Featuurid

API võimekused

✓ Voogedastus

✓ Funktsioonide kasutamine

✓ Assistants API

✓ Pildi sisend

✓ Liivakast

Lühikirjeldus

Praegu dokumenteeritud Token Plan API kasutab Bearer API võtmeid ning võimaldab pilte genereerida lõpp-punkti /images/generations kaudu ja pilte redigeerida lõpp-punkti /images/edits kaudu. Viimases avalikus teadaandes kirjeldatakse mudelit sensenova-u1.5-lite, viitepildi redigeerimist, viiba laiendamist, ajutisi pildi-URL-e, Base64-väljundit, vesimärgi seadeid ning kuni 4096 × 4096 pikslise väljundi loomist. Varasem ametlik dokumentatsioon kirjeldab vestluslikke multimodaalseid päringuid aadressil https://api.sensenova.cn/v1/llm/chat-completions, sealhulgas pildi- ja videosisendit ning SSE-voogedastust. SenseTime teatas 2024. aastal avalikult funktsioonikutsete ja Assistants API kasutuselevõtust. Praegune avalik dokumentatsioon ei paku täielikku ja kontrollitavat ülevaadet struktureeritud JSON-väljundi, üldise failide üleslaadimise, peenhäälestuse, viiteaja tasemete ega kõigi assistendi käituskeskkonna funktsioonide kohta. Seetõttu tuleks neid kontrollida aktiivsest konsoolist ja kontopõhisest dokumentatsioonist.

Näited

API Näited

#!/usr/bin/env bash
set -euo pipefail

: "${SENSENOVA_API_KEY:?Set SENSENOVA_API_KEY first}"
BASE_URL="${SENSENOVA_BASE_URL:-https://token.sensenova.cn/v1}"
MODEL="${SENSENOVA_IMAGE_MODEL:-sensenova-u1.5-lite}"

response=$(curl --fail-with-body --silent --show-error \
  --request POST "$BASE_URL/images/generations" \
  --header "Authorization: Bearer $SENSENOVA_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$(cat <<JSON
{
  "model": "$MODEL",
  "prompt": "A realistic photograph of a red fox in a snowy forest at sunrise",
  "n": 1,
  "size": "1024x1024",
  "watermark": true,
  "prompt_extend": true,
  "response_format": "url"
}
JSON
)")

printf '%s\n' "$response"

if command -v jq >/dev/null 2>&1; then
  printf 'Generated image URL: %s\n' "$(printf '%s' "$response" | jq -r '.data[0].url // empty')"
fi

# Installation: python -m pip install requests
import os
import sys
import requests

BASE_URL = os.getenv("SENSENOVA_BASE_URL", "https://token.sensenova.cn/v1")
API_KEY = os.getenv("SENSENOVA_API_KEY")
MODEL = os.getenv("SENSENOVA_IMAGE_MODEL", "sensenova-u1.5-lite")

if not API_KEY:
    raise SystemExit("Set SENSENOVA_API_KEY before running this program")

def generate_image(prompt: str) -> str:
    response = requests.post(
        f"{BASE_URL}/images/generations",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
        },
        json={
            "model": MODEL,
            "prompt": prompt,
            "n": 1,
            "size": "1024x1024",
            "watermark": True,
            "prompt_extend": True,
            "response_format": "url",
        },
        timeout=120,
    )
    try:
        response.raise_for_status()
    except requests.HTTPError as exc:
        raise RuntimeError(f"SenseNova API error {response.status_code}: {response.text}") from exc
    payload = response.json()
    try:
        return payload["data"][0]["url"]
    except (KeyError, IndexError, TypeError) as exc:
        raise RuntimeError(f"Unexpected SenseNova response: {payload}") from exc

try:
    image_url = generate_image("A small sailboat on a calm blue lake under dramatic clouds")
    print(image_url)
except (requests.RequestException, RuntimeError) as exc:
    print(str(exc), file=sys.stderr)
    sys.exit(1)

// Installation: npm install openai
import OpenAI from "openai";

const apiKey = process.env.SENSENOVA_API_KEY;
if (!apiKey) {
  throw new Error("Set SENSENOVA_API_KEY before running this program");
}

const client = new OpenAI({
  apiKey,
  baseURL: process.env.SENSENOVA_BASE_URL || "https://token.sensenova.cn/v1"
});

try {
  const result = await client.images.generate({
    model: process.env.SENSENOVA_IMAGE_MODEL || "sensenova-u1.5-lite",
    prompt: "A futuristic glass greenhouse on Mars, cinematic lighting",
    n: 1,
    size: "1024x1024",
    response_format: "url",
    watermark: true,
    prompt_extend: true
  });

  const imageUrl = result.data?.[0]?.url;
  if (!imageUrl) {
    throw new Error(`Unexpected SenseNova response: ${JSON.stringify(result)}`);
  }
  console.log(imageUrl);
} catch (error) {
  const status = error?.status ? `HTTP ${error.status}: ` : "";
  console.error(`${status}${error.message}`);
  process.exitCode = 1;
}

<?php
$apiKey = getenv('SENSENOVA_API_KEY');
if (!$apiKey) {
    fwrite(STDERR, "Set SENSENOVA_API_KEY before running this program\n");
    exit(1);
}

$baseUrl = getenv('SENSENOVA_BASE_URL') ?: 'https://token.sensenova.cn/v1';
$model = getenv('SENSENOVA_IMAGE_MODEL') ?: 'sensenova-u1.5-lite';
$url = rtrim($baseUrl, '/') . '/images/generations';

$payload = json_encode([
    'model' => $model,
    'prompt' => 'A quiet Japanese garden after rain, realistic photography',
    'n' => 1,
    'size' => '1024x1024',
    'watermark' => true,
    'prompt_extend' => true,
    'response_format' => 'url'
], JSON_THROW_ON_ERROR);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 15,
    CURLOPT_TIMEOUT => 120,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
        'Accept: application/json'
    ],
    CURLOPT_POSTFIELDS => $payload
]);

$body = curl_exec($ch);
if ($body === false) {
    $error = curl_error($ch);
    curl_close($ch);
    fwrite(STDERR, "Network error: {$error}\n");
    exit(1);
}

$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true);
if ($status < 200 || $status >= 300) {
    fwrite(STDERR, "SenseNova API error {$status}: {$body}\n");
    exit(1);
}
if (!is_array($data) || !isset($data['data'][0]['url'])) {
    fwrite(STDERR, "Unexpected SenseNova response: {$body}\n");
    exit(1);
}

echo $data['data'][0]['url'] . PHP_EOL;
?>

Põhimõtted

Andmete kasutus

SenseNova kehtivas privaatsuspoliitikas on sätestatud, et API-teenuste kaudu esitatud kliendiandmeid ei kasutata mudelite treenimiseks, välja arvatud juhul, kui SenseNova on saanud kliendi sellekohase sõnaselge nõusoleku. Poliitikas märgitakse eraldi, et isikustamata sisendeid ja väljundeid võidakse kasutada teenuste ning nende aluseks olevate tehnoloogiate hooldamiseks, turvamiseks ja täiustamiseks juhul, kui selleks on olemas kohaldatav õiguslik alus.

Andmete säilitamine

Kehtiva privaatsuspoliitika kohaselt võidakse kliendiandmeid säilitada Malaisias asuvates serverites ning Mandri-Hiinas asuvad arvutusressursid võivad sisendeid töödelda ja väljundeid genereerida. Andmeid säilitatakse ajutiselt API-teenuste osutamiseks või seadusest tulenevate nõuete täitmiseks ning need kustutatakse pärast kohaldatavate tingimuste lõppemist, välja arvatud juhul, kui seadusest tulenevad säilitamiskohustused nõuavad nende alleshoidmist.

Päringupiirangud

Praeguse avaliku beetaversiooni teadaandes on SenseNova U1.5 Lite’i puhul märgitud piiranguks 1500 päringut iga viie tunni järel. Laiemaid konto-, mudeli- ja tootmiskeskkonna päringupiiranguid ei õnnestunud usaldusväärselt kontrollida.

Arendaja juhend

SenseNova API juhend: juurdepääs, lõpp-punktid, võimalused ja piirangud

SenseTime’i SenseNova API annab arendajatele juurdepääsu valitud vestlus-, multimodaalsetele, pildiloome-, pilditöötlus- ja muudele tehisintellektiteenustele. Praegu dokumenteeritud Token Plan API kasutab Bearer API-võtmeid ja OpenAI-ga ühilduvat HTTP-vormingut ning pilditöötluse lõpp-punktid asuvad aadressil token.sensenova.cn/v1. SenseNova U1.5 Lite’i tasuta avaliku beetaversiooni kvoot on praegu 1500 päringut iga viie tunni järel, samas kui laiem kommertshinnastus ja mitmed täiustatud võimalused sõltuvad endiselt mudelist ja kasutajakontost.

SenseNova on SenseTime’i arendajaplatvorm, mis võimaldab rakendustel kasutada valitud alusmudeleid ja tehisintellektiteenuseid. Selles juhendis selgitatakse, kuidas hankida API-võti, teha esimene pildigeneratsiooni päring, mõista praegust lõpp-punktide struktuuri, hinnata multimodaalseid ja vestlusfunktsioone ning arvestada lahendamata küsimustega hinnastamise, failide, struktureeritud väljundite ja tootmiskeskkonna piirangute kohta.

SenseNova on SenseTime’i arendajaplatvorm vestlus-, multimaalsete, piltide genereerimise ja piltide redigeerimise teenuste jaoks. Juhend käsitleb juurdepääsu, Bearer-autentimist, praeguseid Token Plani lõpp-punkte, cURL-i ja Pythoni näiteid, U1.5 Lite’i avaliku beetaversiooni kvooti, voogedastust, funktsioonikutsungeid, privaatsust, SDK-valikuid ning failide ja struktureeritud väljunditega seotud lahendamata piiranguid.

Mis on SenseNova API?

SenseNova on SenseTime'i praegune arendajaplatvorm, mille kaudu pääseb valitud tehisintellekti mudelitele ja teenustele ligi HTTPS API-de kaudu. See on mõeldud rakendusi loovatele arendajatele, mitte inimestele, kes kasutavad otse SenseTime'i tarbijatele suunatud assistente.

Platvorm hõlmab rohkem kui üht tüüpi teenuseid. Sõltuvalt mudelist ja kontost võivad arendajad kasutada vestluspõhiseid keelemudeleid, multimodaalseid päringuid, piltide genereerimist, piltide töötlemist, tegelaskujude või assistentide funktsioone ning muid SenseTime'i tehisintellektiteenuseid. Kõige selgemalt dokumenteeritud praegune Token Plan liides kasutab piltide genereerimiseks ja töötlemiseks OpenAI-ga ühilduvat päringustiili.

Dokumenteeritud Token Plan-i baas-URL on https://token.sensenova.cn/v1. Praeguses avalikus teadaandes nimetatakse sensenova-u1.5-lite pildimudeliks ning dokumenteeritakse järgmised lõpp-punktid:

POST /images/generations piltide loomiseks juhiste põhjal.
POST /images/edits piltide töötlemiseks ja võrdluspiltidega seotud töövoogudeks.

SenseNova API-d tasub hinnata siis, kui rakendus vajab Hiinale suunatud tehisintellektiteenuseid, hiinakeelset genereerimist, piltide loomist, piltide töötlemist või multimodaalset töötlust. See on vähem ilmselge valik projektidele, mis vajavad küpset üleilmset tellimusökosüsteemi, järjepidevalt täielikku ingliskeelset dokumentatsiooni, avalikult kättesaadavat kommertshinnastust või kõiki mudeleid hõlmavat täielikult dokumenteeritud funktsioonide maatriksit.

Kellele SenseNova sobib?

SenseNova on eelkõige asjakohane järgmistele kasutajatele:

Arendajad, kes loovad hiinakeelseid või Hiinale suunatud rakendusi.
Meeskonnad, kes vajavad API kaudu teksti põhjal piltide genereerimist või piltide töötlemist.
Rakendused, mis vajavad teksti ning toetatud pildi- või videosisenditega multimodaalseid päringuid.
Organisatsioonid, kes hindavad SenseTime'i ettevõtetele suunatud tehisintellektiökosüsteemi.
Arendajad, kes tunnevad end mugavalt toorete HTTPS-päringute või OpenAI-ga ühilduvate klientide kasutamisel ajal, mil platvormi üksikasjad alles muutuvad.

See võib olla halb valik projektile, mis sõltub stabiilsest ja üleilmselt ühtsest tarbijateenusest, ulatuslikest kolmandate osapoolte integratsioonidest, konkreetse programmeerimiskeele jaoks mõeldud täielikult dokumenteeritud ametlikust SDK-st või universaalsest seadistamist mittevajavast faili- ja struktureeritud väljundi töövoost. Mitmed neist võimalustest on seotud konkreetsete mudelitega, puudulikult dokumenteeritud või praeguste avalike materjalide põhjal ebausaldusväärselt kontrollitavad.

Kuidas saada ligipääs ja API-võti?

Ligipääs API-le algab SenseNova platvormilt ja arendajakonsoolist. Tüüpiline seadistus on järgmine:

Looge SenseNova konto või registreeruge kasutajaks.
Läbige nõutud konto kinnitamise toimingud.
Avage konsoolis arendaja- või Token Plan-i jaotis.
Looge API-võti.
Kontrollige, millised mudelid, kvoodid ja lõpp-punktid on kontol lubatud.

SenseNova API-võtmed saadetakse Beareri tunnustena. Väidetavalt algavad võtmed märgijadaga sk-, kuid rakendused ei tohiks võtme valideerimisel sellele eesliitele tugineda. Salvestage võti keskkonnamuutujasse või saladuste haldurisse. Ärge paigutage seda brauseri JavaScripti, mobiilirakenduse paketti ega lähtekoodihoidla failidesse, sest igaüks, kes rakenduse kätte saab, võib võtme potentsiaalselt välja võtta.

Näiteks määrake võti serveripoolses shellis enne integratsiooni käivitamist:

export SENSENOVA_API_KEY="your-api-key"
export SENSENOVA_BASE_URL="https://token.sensenova.cn/v1"
export SENSENOVA_IMAGE_MODEL="sensenova-u1.5-lite"

Konsool on oluline, sest SenseNoval on mitu API-generatsiooni ja mudelipõhist liidest. Ärge eeldage, et vanemas dokumentatsioonis loetletud lõpp-punkt või mudel on saadaval kõigil kontodel.

Sobiva API ja mudeli valimine

Valige API toimingu põhjal, mitte ärge käsitlege SenseNovat ühe vahetatava lõpp-punktina.

Ülesanne	Dokumenteeritud marsruut või liides	Mida kontrollida
Teksti põhjal piltide genereerimine	`/images/generations` Token Plan-i baas-URL-il	Lubatud pildimudel, väljundi vorming, suurus ja kvoot
Piltide töötlemine või võrdluspiltidega seotud töövood	`/images/edits` Token Plan-i baas-URL-il	Aktsepteeritav pildivorming, töötlemisparameetrid ja ligipääs mudelile
Vestluspõhised või multimodaalsed päringud	SenseNova vestlus-API dokumentatsioon	Praegune lõpp-punkt, mudel, toetatud meediatüübid ja konto ligipääs
Funktsioonikutsed või assistendid	Välja kuulutatud SenseChat platvormi võimalused	Kas funktsioon on lubatud ja siht-API jaoks praegu dokumenteeritud

Uue pildiintegratsiooni puhul kasutab praegune avalik näide sensenova-u1.5-lite koos väärtusega https://token.sensenova.cn/v1. Vestluspõhise ja multimodaalse töö puhul on ametlikus dokumentatsioonis kirjeldatud SenseNova vestluse lõpetamise liidest, mis toetab voogedastust ning pildi- ja videosisendit. Kuna platvorm muutub, kinnitage enne juurutamist täpne lõpp-punkt ja mudel kasutusel olevast konsoolist.

Esimese päringu tegemine cURL-iga

Lihtsaim praegu dokumenteeritud lähtekoht on piltide genereerimise päring. Näites kasutatakse Token Plan API-t, Beareri autentimist ja JSON-keha. Päring palub ühe 1024 × 1024 pikslise pildi ning ajutist URL-i vastuses.

curl --fail-with-body --silent --show-error 
  --request POST "${SENSENOVA_BASE_URL}/images/generations" 
  --header "Authorization: Bearer ${SENSENOVA_API_KEY}" 
  --header "Content-Type: application/json" 
  --data '{
    "model": "sensenova-u1.5-lite",
    "prompt": "A realistic photograph of a red fox in a snowy forest at sunrise",
    "n": 1,
    "size": "1024x1024",
    "watermark": true,
    "prompt_extend": true,
    "response_format": "url"
  }'

Edukas vastus sisaldab genereeritud andmeid, sealhulgas pildi URL-i, kui response_format väärtuseks on määratud url. Praeguses teadaandes öeldakse, et need pildi-URL-id aeguvad 24 tunni pärast. Seega laadige pilt alla või kopeerige see püsivasse salvestuskohta, kui rakendus vajab seda hiljem.

Sama päring Pythonis

Ametlikud avalikult kättesaadavad näited kasutavad tavalisi HTTP-päringuid ega nõua SenseNova-spetsiifilist Pythoni paketti. Järgmises näites kasutatakse laialt levinud teeki requests ning lisatakse põhilised oleku- ja vastusekuju kontrollid.

import os
import requests

base_url = os.getenv("SENSENOVA_BASE_URL", "https://token.sensenova.cn/v1")
api_key = os.environ["SENSENOVA_API_KEY"]
model = os.getenv("SENSENOVA_IMAGE_MODEL", "sensenova-u1.5-lite")

response = requests.post(
    f"{base_url}/images/generations",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "model": model,
        "prompt": "A small sailboat on a calm blue lake under dramatic clouds",
        "n": 1,
        "size": "1024x1024",
        "watermark": True,
        "prompt_extend": True,
        "response_format": "url",
    },
    timeout=120,
)

response.raise_for_status()
payload = response.json()
image_url = payload["data"][0]["url"]
print(image_url)

Tootmiskood peaks käsitlema võrgutõrkeid, JSON-väliseid veavastuseid, puuduvaid välju ja ajutisi URL-e, mitte eeldama, et iga edukas HTTP-vastus on oodatud kujuga.

Vastuste mõistmine

Dokumenteeritud pildinäited kasutavad andmemassiivi. URL-vastuste puhul loetakse esimene genereeritud element teelt nagu data[0].url. Kui API on seadistatud tagastama Base64-väljundi, erinevad nii vastuse kuju kui ka salvestusprotsess. Seetõttu peaks rakendus kontrollima valitud vastusevormingut ja valideerima tagastatud välja.

Ärge käsitlege tagastatud URL-i püsiva salvestuskohana. Dokumenteeritud kehtivusaeg on 24 tundi. Praktiline töövoog on kontrollida HTTP-olekut, parsida JSON, hankida pilt kiiresti ja salvestada see rakenduse hallatavasse salvestuskohta.

Vestluspõhiste API-de puhul kirjeldatakse dokumentatsioonis kasutusteavet ja voovälju. Voogedastusvastus saadab osalised tulemused Server-Sent Events-ina, selle asemel et oodata täielikku vastust. Klient peab sündmuste lugemist jätkama, käsitlema ühenduse katkemisi ning koostama lõpliku teksti või tööriistaga seotud tulemuse vastavalt lõpp-punkti vastusevormingule.

Kuidas SenseNova hinnastus ja kvoodid toimivad?

SenseNova ei esita praegu kõigile API-võimalustele üht universaalset tellimishinda. API ligipääs põhineb kasutusel või kvoodil ning tingimused sõltuvad mudelist, kontost ja paketist.

sensenova-u1.5-lite praeguses avaliku beetaversiooni teadaandes öeldakse, et mudel on tasuta kasutatav kvoodiga 1500 päringut iga viie tunni järel. See on avaliku beetaversiooni kvoot, mitte garantii, et kõik SenseNova mudelid või tulevased tootmiskontod jäävad tasuta kasutatavaks.

Kõigi mudelite täielikku ja usaldusväärset kommertshinnakirja ei õnnestunud avalikult kättesaadava ametliku materjali põhjal kontrollida. Enne tootmissüsteemi eelarvestamist vaadake hinna- ja konsoolilehelt järgmist:

Kas valitud mudel on tasuta, tokenipõhise hinnaga, päringupõhise hinnaga või mõõdetakse kasutust muul viisil.
Kvoodiaknad ja kontotaseme piirangud.
Tootmiskeskkonna päringupiirangud.
Pildi suuruse, väljundite arvu või meediaga seotud tasud.
Muudatused, mis võivad rakenduda avaliku beetaversiooni lõppemisel.

Millele arendajad ligi pääsevad?

Piltide genereerimine ja töötlemine

Praegune Token Plan-i dokumentatsioon toetab teksti põhjal piltide genereerimist ja piltide töötlemist. Dokumenteeritud pildimudel toetab võrdluspiltidega seotud töövooge, juhiste laiendamist, vesimärgi juhtelemente ja väljundsuurusi kuni 4096 × 4096 pikslit. API võib sõltuvalt päringust tagastada ajutisi URL-e või Base64-väljundi.

Multimodaalne sisend

SenseNova vestlusdokumentatsioon kirjeldab päringuid, mis võivad sisaldada teksti koos toetatud pildi- ja videosisenditega. Meedia piirangud ja aktsepteeritavad vormingud sõltuvad mudelist. Rakendused peaksid lähtuma lubatud mudeli juures näidatud piirangutest, mitte eeldama, et kõik vestlusmudelid aktsepteerivad samu faile või meediasuurusi.

Voogedastus

Vestluspõhiste API-de voogedastust dokumenteeritakse Server-Sent Events-i kaudu, mida lühendatakse sageli SSE-ks. Ühe valmis vastuse asemel saab klient sündmuste jada ning võib osalist väljundit selle saabumisel kuvada või töödelda. Voogedastus on interaktiivsete liideste puhul kasulik, kuid nõuab katkenud ühenduste, poolikute voogude ning lõpliku kasutus- või olekuteabe käsitlemist.

Funktsioonikutsed ja assistendid

SenseTime on SenseChat platvormi osana avalikult välja kuulutanud funktsioonikutsed ja Assistants API. Funktsioonikutsed võimaldavad mudelil paluda rakendusel käivitada määratud funktsiooni, näiteks kontrollida tellimuse olekut või arvutada väärtust; toimingu käivitamise ja valideerimise eest vastutab endiselt rakendus.

Praegune avalik Token Plan-i materjal ei paku täielikku ja ajakohast viidet kõigi tööriistakutsete või assistendi käituskeskkonna funktsioonide kohta. Käsitlege neid võimalusi tootepinna, mudeli ja kontoga seotud funktsioonidena. Enne nendele tuginemist kinnitage täpne päringuskeem ja saadavus ajakohasest arendajadokumentatsioonist.

Failid ja struktureeritud väljundid

Üldist failide üleslaadimist ei ole praeguse ja universaalselt kättesaadava Token Plan-i funktsioonina usaldusväärselt kinnitatud. Asjakohaste vestlusmudelite puhul on dokumenteeritud multimodaalsed pildi- ja videosisendid, kuid see ei ole sama mis üldotstarbeline failide API.

Samuti ei ole kinnitatud täielikku ja ajakohast garantiid struktureeritud JSON-väljundi kohta. Kui rakendus vajab skeemi alusel valideeritud väljundit, kontrollige, kas valitud mudel ja lõpp-punkt seda sõnaselgelt toetavad. Ärge järeldage seda võimalust üksnes API JSON-edastusvormingu põhjal.

Täiustatud integratsioonimustrid

Piltide töötlemise töövoog

Töötlemiseks või võrdluspildi põhjal genereerimiseks kasutage dokumenteeritud marsruuti /images/edits, mitte ärge saatke pilditöötluse toimingut genereerimise lõpp-punkti. Kinnitage praegusest SenseNova dokumentatsioonist nõutav multipart- või JSON-päringu vorming, aktsepteeritav võrdluspildi esitusviis ja ligipääs mudelile. Avalikud materjalid kinnitavad lõpp-punkti ja võimaluse olemasolu, kuid ei paku kõigi töötlemisvoogude jaoks täielikku universaalset skeemi.

Usaldusväärse kliendi loomine

Tootmisklient peaks hoidma baas-URL-i ja mudeli nime seadistatavana. Samuti peaks see:

Hoidma API-võtmeid usaldusväärses serveris.
Määrama ühenduse ja kogu päringu ajalõpu.
Kontrollima enne vastuse parsimist HTTP-olekukoode.
Käsitlema piirkiiruse ületamist ja ajutisi teenusetõrkeid piiratud korduskatsetega.
Valideerima vastuse skeemi enne URL-ide, Base64-andmete või genereeritud teksti kasutamist.
Salvestama päringu identifikaatorid või turvalised tööandmed, kuid mitte logima privaatseid juhiseid ega saladusi.
Laadima ajutised pildi-URL-id alla enne nende aegumist.
Kasutama mudelipõhist testikomplekti mudelite või lõpp-punktide vahetamisel.

SDK-d, mänguväljak ja arendajatööriistad

Kõige turvalisem praegu dokumenteeritud integratsioonimeetod on toor-HTTPS, kasutades requests, cURL-i või muud tavalist HTTP-klienti. Token Plan-i liidest kirjeldatakse dokumenteeritud pilditoimingute puhul OpenAI-ga ühilduvana ning ühilduvad kliendid võivad töötada, kui need seadistada SenseNova baas-URL-i ja võtmega. Kättesaadav ametlik materjal ei kinnitanud siiski Token Plan API jaoks ajakohast esimese osapoole Pythoni, JavaScripti ega PHP SDK paketti. Ärge eeldage, et teise teenusepakkuja SDK näited on ametlikult toetatud.

SenseNova platvormi kaudu on saadaval konsool ja mänguväljaku-laadne arenduskeskkond. Kasutage neid võtmete loomiseks, lubatud teenuste kontrollimiseks ja päringute testimiseks enne koodi tootmisse viimist. Konsool on ka parim koht praeguste mudelinimede, kvootide ja kontospetsiifilise dokumentatsiooni kontrollimiseks.

Privaatsus ja andmete käsitlemine

Praeguses SenseNova privaatsuspoliitikas öeldakse, et API-teenuste kaudu saadetud kliendiandmeid ei kasutata mudelite treenimiseks, välja arvatud juhul, kui SenseNova on saanud kliendi sellekohase sõnaselge nõusoleku. Eraldi kirjeldatakse tuvastamatuks muudetud sisendite ja väljundite võimalikku kasutamist teenuste hooldamiseks, turvamiseks ja täiustamiseks, kui selleks on olemas kohaldatav õiguslik alus.

Poliitika kohaselt võidakse kliendiandmeid säilitada Malaisia serverites ning Mandri-Hiinas asuvad arvutusressursid võivad sisendeid töödelda ja väljundeid genereerida. Andmeid võidakse teenuse osutamiseks või õiguslike kohustuste täitmiseks ajutiselt säilitada ning nende kustutamist pärast kohaldatavate tingimuste lõppemist kirjeldatakse vaikimisi, välja arvatud juhul, kui seadus nõuab säilitamist.

Reguleeritud, konfidentsiaalset või isikuandmeid sisaldavat teavet töötlevad organisatsioonid peaksid enne tootmisandmete saatmist tutvuma praeguse privaatsuspoliitika, andmetöötlustingimuste, piirkondlike töötlemiskorralduste ja võimaliku ettevõttelepinguga.

Olulised piirangud ja ebakindlused

SenseNova avalik API-teave ei ole veel täielik ühe versiooni kohta käiv teatmik. Peamised kavandamist vajavad probleemid on järgmised:

Mitu API-generatsiooni: uuemates Token Plan-i näidetes kasutatakse token.sensenova.cn/v1, samas kui vanemas vestlusdokumentatsioonis kasutatakse SenseNova teistsugust API-pinda.
Puudulik ingliskeelne katvus: oluline põhjalik dokumentatsioon on suuresti hiinakeelne ning avalik ingliskeelne materjal ei pruugi kirjeldada kõiki parameetreid.
Mudelipõhised funktsioonid: meediasisendid, pildisuurused, kvoodid ja vastusevalikud võivad mudeliti erineda.
Ebaselged universaalsed piirangud: laiemaid päringupiiranguid, latentsusklasse, peenhäälestust ja üldist failide üleslaadimist ei ole usaldusväärselt kinnitatud.
Ajutised pilditulemused: dokumenteeritud pildi-URL-id aeguvad 24 tunni pärast.
Avaliku beetaversiooni muudatused: U1.5 Lite'i 1500 päringu kvoot võib teenuse beetaversioonist väljumisel muutuda.
Piirkondlik saadavus: ökosüsteem on tugevalt Hiinale suunatud ning konto kinnitamine või ligipääs võib piirkonniti erineda.

Seetõttu tuleb testida täpselt seda konto ja mudeli kombinatsiooni, mida tootmises kasutama hakatakse. Need ei ole tingimata iga SenseNova juurutuse puudused, kuid muudavad seadistuse tuvastamise ja jälgimise oluliseks.

Eelised ja piirangud lühidalt

Eelised	Piirangud
Praegused pildilõpp-punktid kasutavad tuttavat OpenAI-ga ühilduvat HTTP-mustrit.	Kommertshinnastust ei saa avalikult kättesaadavate materjalide põhjal täielikult kontrollida.
Toetatud on dokumenteeritud piltide genereerimine, töötlemine ja võrdluspiltidega seotud töövood.	API-generatsioonid ja lõpp-punktide dokumentatsioon ei ole koondatud ühte täielikku teatmikku.
Vestluspõhiste API-de dokumentatsioon kirjeldab multimodaalseid sisendeid ja SSE-voogedastust.	Faile, struktureeritud väljundeid, peenhäälestust ja laiemaid tootmispiiranguid ei ole täielikult dokumenteeritud.
Dokumenteeritud U1.5 Lite'i mudeli jaoks on saadaval tasuta avaliku beetaversiooni kvoot.	Saadavus ja dokumentatsioon on rohkem Hiinale suunatud ning inglise keeles vähem täielikud.
Toor-HTTPS-i integratsioon ei nõua teenusepakkuja-spetsiifilist SDK-d.	Ajutised pildi-URL-id tuleb kiiresti alla laadida ja püsivalt salvestada.

Millal valida või vältida SenseNovat?

SenseNova on hea kandidaat siis, kui sihtkasutajad või juurutuspiirkond sobituvad SenseTime'i Hiinale suunatud ökosüsteemiga, kui piltide genereerimine või töötlemine on rakenduse keskne osa või kui meeskond tunneb end mugavalt dokumenteeritud HTTP-lõpp-punktide integreerimise ja mudelipõhise käitumise valideerimisega.

See on nõrgem valik juhul, kui projekt vajab üleilmselt ühtset teenust koos ulatusliku ingliskeelse dokumentatsiooniga, iga võimaluse kohta selgelt avaldatud hinnakirja, konkreetse keele jaoks garanteeritud ametlikku SDK-d või põhjalikult dokumenteeritud failide, struktureeritud väljundite ja assistendi käituskeskkonna lahendust. Sellisel juhul võrrelge täpseid nõudeid kasutusel oleva SenseNova konsooliga, mitte üksnes platvormi üldiste teadaannetega.

Hindamise alustamiseks kasutage võimaluse korral tasuta avaliku beetaversiooni kvooti, looge väike serveripoolne integratsioon, mõõtke vastuste käitumist ja kvoodi kasutust ning kontrollige enne rakenduse andmete või liikluse saatmist privaatsust, piirkondlikku töötlemist ja tootmishindu.

Allikad 7

platform.sensenova.cn/docs ↗ platform.sensenova.cn/product/APIService/document ↗ platform.sensenova.cn/product/APIService/pricing ↗ sensetime.com/en/news/sensenova-u1-5-lite-token-plan-20260911-1741 ↗ sensetime.com/en/news/51167493 ↗ platform.sensenova.ai/html/PrivacyPolicy.html ↗ www.sensetime.com/en/ ↗