public static async UniTask<bool> InitializeAsync(string developerToken = null)

// Wait for SDK to finish initializing (editor token or player login handled automatically)
await PlayKitSDK.InitializeAsync();

public static bool IsReady()

public static PlayKit_PlayerClient GetPlayerClient()

public static PlayKit_AIChatClient CreateChatClient(string modelName = null)

public static PlayKit_AIImageClient CreateImageClient(string modelName = null)

public static PlayKit_AudioTranscriptionClient CreateTranscriptionClient(string modelName)

public static PlayKit_TextToSpeechClient CreateTextToSpeechClient(string modelName = null)

public static void CreateNpc(PlayKit_NPC recipient, string modelName = null)

public async UniTask<PlayKit_AIResult<string>> TextGenerationAsync(
    PlayKit_ChatConfig config,
    CancellationToken cancellationToken
)

var config = new PlayKit_ChatConfig
{
    Messages = messages,
    Temperature = 0.7f
};

var result = await chatClient.TextGenerationAsync(config, cancellationToken);
if (result.Success)
{
    Debug.Log(result.Response);
}

public async UniTask TextChatStreamAsync(
    PlayKit_ChatStreamConfig config,
    Action<string> onNewChunk,
    Action<string> onConcluded,
    CancellationToken cancellationToken
)

public async UniTask<JObject> GenerateStructuredAsync(
    string schemaName,
    string prompt,
    float temperature = 0.7f,
    CancellationToken cancellationToken = default
)

public async UniTask<T> GenerateStructuredAsync<T>(
    string schemaName,
    string prompt,
    float temperature = 0.7f,
    CancellationToken cancellationToken = default
)

public async UniTask<JObject> GenerateStructuredWithSchemaAsync(
    string schemaJson,
    string prompt,
    float temperature = 0.7f,
    CancellationToken cancellationToken = default
)

public bool HasSchema(string schemaName)

public string[] GetAvailableSchemas()

public void SetSchemaLibrary(PlayKit_SchemaLibrary schemaLibrary)

public static void PrintPrettyChatMessages(
    List<PlayKit_ChatMessage> messages,
    string title = "Chat Messages"
)

public async UniTask<PlayKit_GeneratedImage> GenerateImageAsync(
    string prompt,
    string size,
    int? seed,
    CancellationToken cancellationToken
)

public async UniTask<List<PlayKit_GeneratedImage>> GenerateImagesAsync(
    string prompt,
    int count,
    string size,
    string aspectRatio,
    int? seed,
    CancellationToken cancellationToken
)

public static Texture2D Base64ToTexture2D(string base64Data)

public static Sprite Texture2DToSprite(Texture2D texture)

public async UniTask<PlayKit_TranscriptionResult> TranscribeAsync(
    byte[] audioData,
    string language,
    string prompt,
    CancellationToken cancellationToken
)

public async UniTask<PlayKit_TranscriptionResult> TranscribeAudioClipAsync(
    AudioClip audioClip,
    string language,
    string prompt,
    CancellationToken cancellationToken
)

public async UniTask<PlayKit_SpeechResult> SynthesizeAsync(
    string text,
    string voice,
    float? speed,
    CancellationToken cancellationToken
)

public async UniTask<AudioClip> SynthesizeToAudioClipAsync(
    string text,
    string voice,
    float? speed,
    CancellationToken cancellationToken
)

public bool IsTalking { get; }

public bool IsReady { get; }

public string CharacterDesign { get; }

public void SetCharacterDesign(string prompt)

npc.SetCharacterDesign("You are a friendly villager");

public async UniTask<string> Talk(
    string message,
    CancellationToken cancellationToken
)

public async UniTask TalkStream(
    string message,
    Action<string> onChunk,
    Action<string> onComplete,
    CancellationToken cancellationToken
)

public void ClearHistory()

public PlayKit_ChatMessage[] GetHistory()

public int GetHistoryLength()

public bool RevertHistory()

public int RevertChatMessages(int count)

public void AppendChatMessage(string role, string content)

public string SaveHistory()

public bool LoadHistory(string saveData)

public void PrintPrettyChatMessages(string title)

public async UniTask<(bool, string)> InitializeAsync(
    string jwt,
    CancellationToken cancellationToken
)

public async UniTask<ApiResult<PlayerInfo>> GetPlayerInfoAsync(
    CancellationToken cancellationToken
)

public PlayerInfo GetCachedPlayerInfo()

public bool HasValidPlayerToken()

public string GetPlayerToken()

public void SetPlayerToken(string token)

public event Action<PlayerInfo> OnPlayerInfoUpdated

public event Action<string> OnPlayerTokenReceived

public event Action<string> OnError

public bool IsRecording { get; }

public float RecordingTime { get; }

public string CurrentDevice { get; }

public AudioClip LastRecording { get; }

public float maxRecordingSeconds = 60f

public int sampleRate = 16000

public bool useVAD = true

public float silenceThreshold = 0.01f

public float maxSilenceDuration = 2.0f

public bool StartRecording(string deviceName = null)

public AudioClip StopRecording()

public void CancelRecording()

public float GetCurrentVolume()

public void SetMicrophoneDevice(string deviceName)

public static string[] GetAvailableDevices()

public event Action OnRecordingStarted

public event Action<AudioClip> OnRecordingStopped

public event Action<float> OnVolumeChanged

public class PlayKit_ChatMessage
{
    public string Role;      // "system", "user", "assistant"
    public string Content;   // Message content
}

public class PlayKit_ChatConfig
{
    public List<PlayKit_ChatMessage> Messages { get; set; }
    public float Temperature { get; set; } = 0.7f;
}

public class PlayKit_ChatStreamConfig
{
    public List<PlayKit_ChatMessage> Messages { get; set; }
    public float Temperature { get; set; } = 0.7f;
}

public class PlayKit_AIResult<T>
{
    public bool Success { get; }
    public T Response { get; }
    public string ErrorMessage { get; }
}

public class PlayKit_GeneratedImage
{
    public string ImageBase64 { get; set; }
    public string OriginalPrompt { get; set; }
    public string RevisedPrompt { get; set; }
    public DateTime GeneratedAt { get; set; }

    public Texture2D ToTexture2D()
    public Sprite ToSprite()
}

public class PlayKit_TranscriptionResult
{
    public bool Success { get; }
    public string Text { get; }
    public string Language { get; }
    public float? DurationInSeconds { get; }
    public PlayKit_TranscriptionSegment[] Segments { get; }
    public string Error { get; }
}

public class PlayKit_TranscriptionSegment
{
    public float Start;  // Start time (seconds)
    public float End;    // End time (seconds)
    public string Text;  // Segment text
}

public class PlayKit_SpeechResult
{
    public bool Success { get; }
    public byte[] AudioData { get; }        // Raw audio bytes
    public string Format { get; }           // Output format (e.g. "mp3")
    public int UsageCharacters { get; }     // Characters billed for this request
    public float? AudioLengthMs { get; }    // Audio duration in milliseconds
    public string Error { get; }
}

public class PlayerInfo
{
    public string UserId { get; set; }
    public float Credits { get; set; }
}

public class PlayKitException : Exception

public class PlayKitApiErrorException : PlayKitException

public class PlayKitImageSizeValidationException : PlayKitApiErrorException

var chatClient = PlayKitSDK.Factory.CreateChatClient();

var config = new PlayKit_ChatConfig
{
    Messages = new List<PlayKit_ChatMessage>
    {
        new PlayKit_ChatMessage { Role = "user", Content = "Hello" }
    }
};

var result = await chatClient.TextGenerationAsync(config, cancellationToken);
if (result.Success)
{
    Debug.Log(result.Response);
}

var npc = GetComponent<PlayKit_NPC>();
npc.SetCharacterDesign("You are a friendly merchant");

string reply = await npc.Talk("Hello", cancellationToken);
Debug.Log(reply);

var imageClient = PlayKitSDK.Factory.CreateImageClient();

var result = await imageClient.GenerateImageAsync(
    "a beautiful landscape",
    "1024x1024",
    null,
    cancellationToken
);

if (result != null)
{
    image.sprite = result.ToSprite();
}

var recorder = GetComponent<PlayKit_MicrophoneRecorder>();
recorder.StartRecording();

// ... wait for recording to complete ...

AudioClip clip = recorder.StopRecording();

var transcriptionClient = PlayKitSDK.Factory.CreateTranscriptionClient("whisper-1");
var result = await transcriptionClient.TranscribeAudioClipAsync(
    clip,
    "en",
    null,
    cancellationToken
);

if (result.Success)
{
    Debug.Log(result.Text);
}