Release infinitetalk SDK

Per-method documentation for all resource methods.

Author: runapi-builder

README.md

@@ -80,6 +80,10 @@ Use the most specific infinitetalk api variant page for pricing, rate limits, an
 
 Default pricing link for the infinitetalk api SDK: https://runapi.ai/models/infinitetalk
 
+## Generated file storage
+
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## FAQ
 
 ### Which package should I install for infinitetalk api work?

go/README.md

@@ -28,6 +28,8 @@ status, err := client.FromAudios.Get(context.Background(), task.ID)
 
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.
 
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## Language notes
 
 Use the public Go module with `github.com/runapi-ai/core-sdk/go` options when building video services, CLIs, or workers. The available resources include from audios. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.

go/go.mod

@@ -2,4 +2,4 @@ module github.com/runapi-ai/infinitetalk-sdk/go
 
 go 1.26
 
-require github.com/runapi-ai/core-sdk/go v0.2.5
+require github.com/runapi-ai/core-sdk/go v0.2.6

go/go.sum

@@ -1,2 +1,2 @@
-github.com/runapi-ai/core-sdk/go v0.2.5 h1:fYs9hl4yAlQj6N6J638tnOUBN+aiALmRxH4t0LfBOGw=
-github.com/runapi-ai/core-sdk/go v0.2.5/go.mod h1:e5uC8RF6BNkAj1WkOi+nD71mZL+cir+Ia97XUQj+5N0=
+github.com/runapi-ai/core-sdk/go v0.2.6 h1:wKlwZV2bJzV3N34wCCuQyNsHJmVFrsV1WvKhQex+P90=
+github.com/runapi-ai/core-sdk/go v0.2.6/go.mod h1:e5uC8RF6BNkAj1WkOi+nD71mZL+cir+Ia97XUQj+5N0=

go/infinitetalk/client.go

@@ -12,16 +12,21 @@ package infinitetalk
 import (
 	"context"
 
+	"github.com/runapi-ai/core-sdk/go/base"
 	"github.com/runapi-ai/core-sdk/go/core"
 	"github.com/runapi-ai/core-sdk/go/option"
 )
 
 const audioToVideoPath = "/api/v1/infinitetalk/audio_to_video"
 
+// Client provides access to InfiniteTalk lip-sync video generation.
 type Client struct {
+	base.Base
 	AudioToVideo *AudioToVideo
 }
 
+// NewClient creates an InfiniteTalk client with the given options.
+// At minimum an API key is required (via option.WithAPIKey or the RUNAPI_API_KEY environment variable).
 func NewClient(opts ...option.ClientOption) (*Client, error) {
 	resolved, err := option.ResolveClientOptions(opts...)
 	if err != nil {
@@ -34,20 +39,31 @@ func NewClient(opts ...option.ClientOption) (*Client, error) {
 	return NewClientWithHTTP(httpClient), nil
 }
 
+// NewClientWithHTTP creates an InfiniteTalk client using a pre-configured HTTP client,
+// useful for shared connection pooling or custom transport settings.
 func NewClientWithHTTP(httpClient core.HTTPClient) *Client {
-	return &Client{AudioToVideo: &AudioToVideo{http: httpClient}}
+	return &Client{Base: base.New(httpClient), AudioToVideo: &AudioToVideo{http: httpClient}}
 }
 
+// AudioToVideo generates lip-synced talking-head videos from a portrait image and an audio track.
+// The generated video shows the person speaking or singing in sync with the audio.
 type AudioToVideo struct{ http core.HTTPClient }
 
+// Create submits an audio-to-video generation task and returns immediately with a task ID.
+// Use Get to poll for the result, or use Run for a blocking helper that polls automatically.
 func (r *AudioToVideo) Create(ctx context.Context, params AudioToVideoParams, opts ...option.RequestOption) (*core.TaskCreateResponse, error) {
 	requestOptions, _ := option.ResolveRequestOptions(opts...)
 	return core.PostJSON[core.TaskCreateResponse](ctx, r.http, audioToVideoPath, core.CompactParams(params), requestOptions)
 }
+
+// Get retrieves the current status and result of an audio-to-video task by its ID.
 func (r *AudioToVideo) Get(ctx context.Context, id string, opts ...option.RequestOption) (*AudioToVideoResponse, error) {
 	requestOptions, _ := option.ResolveRequestOptions(opts...)
 	return core.GetJSON[AudioToVideoResponse](ctx, r.http, core.ResourcePath(audioToVideoPath, id), requestOptions)
 }
+
+// Run submits an audio-to-video task and polls until it completes or fails, returning the final result.
+// This is a convenience wrapper around Create + Get polling. Use option.WithPollingInterval to adjust timing.
 func (r *AudioToVideo) Run(ctx context.Context, params AudioToVideoParams, opts ...option.RequestOption) (*AudioToVideoResponse, error) {
 	_, pollingOptions := option.ResolveRequestOptions(opts...)
 	return core.RunAsync(ctx, func(ctx context.Context) (*core.TaskCreateResponse, error) { return r.Create(ctx, params, opts...) }, func(ctx context.Context, id string) (*AudioToVideoResponse, error) { return r.Get(ctx, id, opts...) }, pollingOptions)

go/infinitetalk/types.go

@@ -1,17 +1,26 @@
 package infinitetalk
 
+// AudioToVideoModel identifies which InfiniteTalk model variant to use for generation.
 type AudioToVideoModel string
 
+// Resolution controls the output video dimensions.
 type Resolution string
 
+// TaskStatus represents the processing state of an asynchronous generation task.
 type TaskStatus string
 
 const (
+	// ModelAudioToVideo is the InfiniteTalk v1 model that generates lip-synced video
+	// from a portrait image and audio track.
 	ModelAudioToVideo AudioToVideoModel = "infinitetalk-from-audio"
-	Resolution480P    Resolution        = "480p"
-	Resolution720P    Resolution        = "720p"
+
+	// Resolution480P produces 480p output, faster to generate and lower cost.
+	Resolution480P Resolution = "480p"
+	// Resolution720P produces 720p output with higher visual fidelity.
+	Resolution720P Resolution = "720p"
 )
 
+// AsyncTaskResponse contains the common fields shared by all asynchronous task responses.
 type AsyncTaskResponse struct {
 	ID     string     `json:"id"`
 	Status TaskStatus `json:"status"`
@@ -22,15 +31,22 @@ func (r AsyncTaskResponse) GetID() string     { return r.ID }
 func (r AsyncTaskResponse) GetStatus() string { return string(r.Status) }
 func (r AsyncTaskResponse) GetError() string  { return r.Error }
 
+// Video holds the URL of a generated video asset.
 type Video struct {
 	URL string `json:"url"`
 }
 
+// AudioToVideoResponse is the result of an audio-to-video generation task.
+// Once the task completes successfully, Videos contains the generated lip-synced video(s).
 type AudioToVideoResponse struct {
 	AsyncTaskResponse
 	Videos []Video `json:"videos,omitempty"`
 }
 
+// AudioToVideoParams configures an audio-to-video lip-sync generation request.
+// Model, SourceImageURL, SourceAudioURL, and Prompt are all required.
+// The source image should be a clear frontal portrait; the audio track drives the lip movements
+// and determines the output video duration.
 type AudioToVideoParams struct {
 	Model            AudioToVideoModel `json:"model" help:"required; model slug"`
 	SourceImageURL   string            `json:"source_image_url" help:"required; source image URL"`

js/README.md

@@ -24,6 +24,8 @@ const status = await client.fromAudios.get(task.id);
 
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion. In web request handlers, prefer `create` plus webhook or later `get` polling so a worker is not held open.
 
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
+
 ## Language notes
 
 Use the TypeScript types in `src/types.ts` and the resource classes under `src/resources` when building video applications. The available resources include from audios. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.

js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runapi.ai/infinitetalk",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "RunAPI InfiniteTalk SDK for JavaScript, Ruby, and Go",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -28,7 +28,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@runapi.ai/core": "^0.2.5"
+    "@runapi.ai/core": "^0.2.6"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

js/skills/infinitetalk/README.md

@@ -70,6 +70,8 @@ const url = result.videos[0].url;
 
 ## Agent rules
 
+- Integration work uses the target language SDK; one-off generation, manual smoke tests, debugging, or user-requested CLI runs use the RunAPI CLI skill: https://github.com/runapi-ai/cli-skill
+- RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
 - Keep API keys in `RUNAPI_API_KEY` or RunAPI CLI config; never commit secrets.
 - Prefer `create`, `get`, and `run` JSON passthrough patterns instead of inventing flags for every model parameter.
 - For infinitetalk api pricing, rate-limit, and commercial-usage answers, link to the model page rather than the repository README.

js/skills/infinitetalk/SKILL.md

@@ -25,14 +25,23 @@ metadata:
 
 Generate and edit video with InfiniteTalk through RunAPI. The default path for one-off agent tasks is the `runapi` CLI; SDKs are for application integration.
 
-## Routing decision
+## Critical: Integration Runtime
 
-- One-off generation, editing, or transformation for the user → use the **CLI path** with the `runapi` binary.
-- Building an app, backend, worker, library, or production codebase → use the **SDK integration path**.
+- Integration work (app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production codebase) uses the **SDK integration path** for the target language.
+- One-off generation, editing, transformation, manual smoke tests, debugging, or user-requested CLI runs use the **CLI path** with the `runapi` binary. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill.
+- Never shell out to the `runapi` CLI as the production runtime integration layer.
+
+## SDK integration path
+
+When integrating InfiniteTalk into an app, backend, worker, library, Rails service, Node service, Go service, webhook pipeline, or production workflow, start by checking the current SDK package and official usage. Confirm install commands, client methods (`create`, `get`, `run`), request fields, response shape, and error classes before using CLI help or raw HTTP examples. Use a RunAPI SDK package:
+
+- JavaScript / TypeScript: `@runapi.ai/infinitetalk`
+- Ruby: `runapi-infinitetalk`
+- Go: `github.com/runapi-ai/infinitetalk-sdk/go`
 
 ## CLI path
 
-The `runapi` binary is the runtime dependency. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth.
+The `runapi` binary is the one-off and manual testing runtime dependency. For full CLI-specific agent guidance, see https://github.com/runapi-ai/cli-skill. Run `runapi auth status` first. For agents and headless runs, prefer `RUNAPI_API_KEY` or import it into saved config with `printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -`. Use `runapi login` only when the user explicitly wants interactive browser auth.
 
 Inspect the available commands and request fields with CLI help:
 
@@ -56,13 +65,9 @@ runapi wait <task-id> --service infinitetalk --action audio-to-video
 
 Available commands: `audio-to-video`.
 
-## SDK integration path
-
-When integrating InfiniteTalk into an app, backend, worker, or library — not for one-off tasks — use a RunAPI SDK package:
+## Generated file storage
 
-- JavaScript / TypeScript: `@runapi.ai/infinitetalk`
-- Ruby: `runapi-infinitetalk`
-- Go: `github.com/runapi-ai/infinitetalk-sdk/go`
+RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
 
 ## References