Client-SDK installieren

Füge das Phaseo-Paket für deine Sprache hinzu, setze PHASEO_API_KEY und sende deine erste Anfrage. Die Übersicht listet für jedes Paket die Registry und die veröffentlichte Version auf.

Paket installieren

npm install @phaseo/sdk

pnpm add @phaseo/sdk

yarn add @phaseo/sdk

Du brauchst Node.js 18 oder neuer und für die Typdefinitionen TypeScript 4.5 oder neuer.

pip install phaseo

uv add phaseo

Du brauchst Python 3.10 oder neuer. Für Echtzeit-Sprache installierst du das Extra: pip install "phaseo[realtime]".

go get github.com/phaseoteam/Phaseo/packages/sdk/sdk-go/v3@latest

Du brauchst Go 1.23 oder neuer. Importiere den Modulpfad v3:

import phaseo "github.com/phaseoteam/Phaseo/packages/sdk/sdk-go/v3"

dotnet add package Phaseo.Sdk

Du brauchst .NET 8 oder neuer. Der Client liegt im Namespace PhaseoSdk.

composer require phaseo/sdk

Du brauchst PHP 8.1 oder neuer und Composer. Composer installiert außerdem Guzzle 7. Die Client-Klasse ist Phaseo\Sdk\Phaseo.

gem install phaseo_sdk

gem "phaseo_sdk"

Du brauchst Ruby 3.0 oder neuer. Lade das Gem mit require 'phaseo_sdk'; der Client ist PhaseoSdk::Phaseo.

Das Artefakt 3.0.0 auf Maven Central enthält die ältere API, ohne die aktuellen APIs für Wiederholungen, Antwort-Metadaten und Parameterprüfung. Um das aktuelle SDK zu verwenden, baust du den festgelegten Quellstand. Du brauchst Java 17 oder neuer, Maven 3.8 oder neuer und Git.

git clone https://github.com/phaseoteam/Phaseo.git
cd Phaseo
git checkout 1ff1119f41ceb3ac2c85ed605f6e1c4beca6e011
mvn -f packages/sdk/sdk-java/pom.xml -DskipTests install

Maven installiert app.phaseo:phaseo-sdk:3.0.0 einschließlich der Jackson-Abhängigkeit in dein lokales Repository. Füge dann die Abhängigkeit hinzu:

<dependency>
  <groupId>app.phaseo</groupId>
  <artifactId>phaseo-sdk</artifactId>
  <version>3.0.0</version>
</dependency>

[dependencies]
phaseo = "0.2"
serde_json = "1"

cargo add phaseo@0.2 serde_json

Du brauchst Rust 1.86 oder neuer. Das Crate ist noch vor 1.0, und seine API kann sich zwischen Minor-Versionen noch ändern. Lege in der Produktion deshalb eine kompatible Minor-Version fest.

API-Schlüssel festlegen

Erstelle einen Schlüssel mit phaseo keys create in der Phaseo CLI oder unter API-Schlüssel und exportiere ihn dann:

export PHASEO_API_KEY="phaseo_v1_sk_<kid>_<secret>"

$env:PHASEO_API_KEY = "phaseo_v1_sk_<kid>_<secret>"

Behalte den Schlüssel auf deinem Server. Kompiliere ihn nicht in eine Desktop-, Mobil- oder Browser-App oder einen anderen verteilten Client.

Anfrage senden

import Phaseo from "@phaseo/sdk";

const client = new Phaseo({
  apiKey: process.env.PHASEO_API_KEY!,
});

const response = await client.generateText({
  model: "openai/gpt-6-astra",
  messages: [{ role: "user", content: "Hello!" }],
});

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

from phaseo import Phaseo
import os

client = Phaseo(api_key=os.environ["PHASEO_API_KEY"])

response = client.generate_text(
    {
        "model": "openai/gpt-6-astra",
        "messages": [{"role": "user", "content": "Hello!"}],
    }
)

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

client, err := phaseo.NewFromEnv() // liest PHASEO_API_KEY
if err != nil {
  panic(err)
}

chat, err := client.GenerateText(context.Background(), phaseo.ChatCompletionsRequest{
  Model:    "openai/gpt-6-astra",
  Messages: []map[string]interface{}{{"role": "user", "content": "Hello!"}},
})
if err != nil {
  panic(err)
}
fmt.Println(chat["choices"])

using PhaseoSdk;

var client = new Phaseo(); // liest PHASEO_API_KEY

var chat = await client.GenerateText(new Dictionary<string, object>
{
    ["model"] = "openai/gpt-6-astra",
    ["messages"] = new[]
    {
        new Dictionary<string, object> { ["role"] = "user", ["content"] = "Hello!" },
    },
});

<?php
require 'vendor/autoload.php';

use Phaseo\Sdk\Phaseo;

$client = new Phaseo(); // liest PHASEO_API_KEY

$chat = $client->generateText([
    'model' => 'openai/gpt-6-astra',
    'messages' => [['role' => 'user', 'content' => 'Hello!']],
]);

echo $chat['choices'][0]['message']['content'];

require 'phaseo_sdk'

client = PhaseoSdk::Phaseo.new # liest PHASEO_API_KEY

chat = client.generate_text(
  model: 'openai/gpt-6-astra',
  messages: [{ role: 'user', content: 'Hello!' }]
)

import app.phaseo.sdk.Phaseo;
import java.util.List;
import java.util.Map;

Phaseo client = new Phaseo(System.getenv("PHASEO_API_KEY"));

var chat = client.createChatCompletion(Map.of(
    "model", "openai/gpt-6-astra",
    "messages", List.of(Map.of("role", "user", "content", "Hello!"))
));
System.out.println(chat.path("choices").path(0).path("message").path("content").asText());

use phaseo::Phaseo;
use serde_json::json;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Phaseo::from_env()?;
    let response = client.chat_completions(&json!({
        "model": "openai/gpt-6-astra",
        "messages": [{ "role": "user", "content": "Hello!" }]
    }))?;

    println!("{}", response.body);
    Ok(())
}

Wenn du keinen Schlüssel übergibst, liest der Client PHASEO_API_KEY selbst.

Client auf eine andere Basis-URL richten

import Phaseo from "@phaseo/sdk";

const client = new Phaseo({
  apiKey: "your-api-key",
  baseUrl: "https://api.phaseo.app/v1",
  timeoutMs: 30_000,
});

from phaseo import Phaseo

client = Phaseo(
    api_key="your-api-key",
    base_url="https://api.phaseo.app/v1",
    timeout=30.0,
)

client := phaseo.New(os.Getenv("PHASEO_API_KEY"), "https://api.phaseo.app/v1")

let client = Phaseo::from_env()?.with_base_url("http://localhost:8787/v1")?;

Das Timeout wird in TypeScript in Millisekunden (timeoutMs) und in Python in Sekunden (timeout) angegeben. In Rust kannst du außerdem PHASEO_BASE_URL setzen (zum Beispiel http://localhost:8787/v1), das Phaseo::from_env() übernimmt. Rust akzeptiert einfaches HTTP nur, wenn der Host genau localhost oder eine Loopback-IP-Adresse ist; entfernte Endpunkte müssen HTTPS verwenden. Die Übersicht listet alle Optionen je Sprache auf. Als Nächstes findest du unter Verwendung ein Beispiel pro Endpunkt oder in der API-Referenz jedes Feld.

Einführung

Text

Bild

Audio

Spezialisiert

Administration

Client-SDK installieren

Client auf eine andere Basis-URL richten

​Client auf eine andere Basis-URL richten

Client auf eine andere Basis-URL richten