# Telnyx Ai Inference Go > >- - **Type:** Skill - **Install:** `agentstack add skill-team-telnyx-ai-telnyx-ai-inference-go` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [team-telnyx](https://agentstack.voostack.com/s/team-telnyx) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [team-telnyx](https://github.com/team-telnyx) - **Source:** https://github.com/team-telnyx/ai/tree/main/providers/claude/plugin/skills/telnyx-ai-inference-go ## Install ```sh agentstack add skill-team-telnyx-ai-telnyx-ai-inference-go ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Telnyx Ai Inference - Go ## Installation ```bash go get github.com/team-telnyx/telnyx-go ``` ## Setup ```go import ( "context" "fmt" "os" "github.com/team-telnyx/telnyx-go" "github.com/team-telnyx/telnyx-go/option" ) client := telnyx.NewClient( option.WithAPIKey(os.Getenv("TELNYX_API_KEY")), ) ``` All examples below assume `client` is already initialized as shown above. ## Error Handling All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code: ```go import "errors" result, err := client.Messages.Send(ctx, params) if err != nil { var apiErr *telnyx.Error if errors.As(err, &apiErr) { switch apiErr.StatusCode { case 422: fmt.Println("Validation error — check required fields and formats") case 429: // Rate limited — wait and retry with exponential backoff fmt.Println("Rate limited, retrying...") default: fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Error()) } } else { fmt.Println("Network error — check connectivity and retry") } } ``` Common error codes: `401` invalid API key, `403` insufficient permissions, `404` resource not found, `422` validation error (check field formats), `429` rate limited (retry with exponential backoff). ## Important Notes - **Pagination:** Use `ListAutoPaging()` for automatic iteration: `iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }`. ## Transcribe speech to text Transcribe speech to text. This endpoint is consistent with the [OpenAI Transcription API](https://platform.openai.com/docs/api-reference/audio/createTranscription) and may be used with the OpenAI JS or Python SDK. `POST /ai/audio/transcriptions` ```go response, err := client.AI.Audio.Transcribe(context.Background(), telnyx.AIAudioTranscribeParams{ Model: telnyx.AIAudioTranscribeParamsModelDistilWhisperDistilLargeV2, }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Text) ``` Returns: `duration` (number), `segments` (array[object]), `text` (string) ## Create a chat completion Chat with a language model. This endpoint is consistent with the [OpenAI Chat Completions API](https://platform.openai.com/docs/api-reference/chat) and may be used with the OpenAI JS or Python SDK. `POST /ai/chat/completions` — Required: `messages` Optional: `api_key_ref` (string), `best_of` (integer), `early_stopping` (boolean), `enable_thinking` (boolean), `frequency_penalty` (number), `guided_choice` (array[string]), `guided_json` (object), `guided_regex` (string), `length_penalty` (number), `logprobs` (boolean), `max_tokens` (integer), `min_p` (number), `model` (string), `n` (number), `presence_penalty` (number), `response_format` (object), `stream` (boolean), `temperature` (number), `tool_choice` (enum: none, auto, required), `tools` (array[object]), `top_logprobs` (integer), `top_p` (number), `use_beam_search` (boolean) ```go response, err := client.AI.Chat.NewCompletion(context.Background(), telnyx.AIChatNewCompletionParams{ Messages: []telnyx.AIChatNewCompletionParamsMessage{{ Role: "system", Content: telnyx.AIChatNewCompletionParamsMessageContentUnion{ OfString: telnyx.String("You are a friendly chatbot."), }, }, { Role: "user", Content: telnyx.AIChatNewCompletionParamsMessageContentUnion{ OfString: telnyx.String("Hello, world!"), }, }}, }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response) ``` ## List conversations Retrieve a list of all AI conversations configured by the user. Supports [PostgREST-style query parameters](https://postgrest.org/en/stable/api.html#horizontal-filtering-rows) for filtering. Examples are included for the standard metadata fields, but you can filter on any field in the metadata JSON object. `GET /ai/conversations` ```go conversations, err := client.AI.Conversations.List(context.Background(), telnyx.AIConversationListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", conversations.Data) ``` Returns: `created_at` (date-time), `id` (uuid), `last_message_at` (date-time), `metadata` (object), `name` (string) ## Create a conversation Create a new AI Conversation. `POST /ai/conversations` Optional: `metadata` (object), `name` (string) ```go conversation, err := client.AI.Conversations.New(context.Background(), telnyx.AIConversationNewParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", conversation.ID) ``` Returns: `created_at` (date-time), `id` (uuid), `last_message_at` (date-time), `metadata` (object), `name` (string) ## Get Insight Template Groups Get all insight groups `GET /ai/conversations/insight-groups` ```go page, err := client.AI.Conversations.InsightGroups.GetInsightGroups(context.Background(), telnyx.AIConversationInsightGroupGetInsightGroupsParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page) ``` Returns: `created_at` (date-time), `description` (string), `id` (uuid), `insights` (array[object]), `name` (string), `webhook` (string) ## Create Insight Template Group Create a new insight group `POST /ai/conversations/insight-groups` — Required: `name` Optional: `description` (string), `webhook` (string) ```go insightTemplateGroupDetail, err := client.AI.Conversations.InsightGroups.InsightGroups(context.Background(), telnyx.AIConversationInsightGroupInsightGroupsParams{ Name: "my-resource", }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", insightTemplateGroupDetail.Data) ``` Returns: `created_at` (date-time), `description` (string), `id` (uuid), `insights` (array[object]), `name` (string), `webhook` (string) ## Get Insight Template Group Get insight group by ID `GET /ai/conversations/insight-groups/{group_id}` ```go insightTemplateGroupDetail, err := client.AI.Conversations.InsightGroups.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", insightTemplateGroupDetail.Data) ``` Returns: `created_at` (date-time), `description` (string), `id` (uuid), `insights` (array[object]), `name` (string), `webhook` (string) ## Update Insight Template Group Update an insight template group `PUT /ai/conversations/insight-groups/{group_id}` Optional: `description` (string), `name` (string), `webhook` (string) ```go insightTemplateGroupDetail, err := client.AI.Conversations.InsightGroups.Update( context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", telnyx.AIConversationInsightGroupUpdateParams{}, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", insightTemplateGroupDetail.Data) ``` Returns: `created_at` (date-time), `description` (string), `id` (uuid), `insights` (array[object]), `name` (string), `webhook` (string) ## Delete Insight Template Group Delete insight group by ID `DELETE /ai/conversations/insight-groups/{group_id}` ```go err := client.AI.Conversations.InsightGroups.Delete(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } ``` ## Assign Insight Template To Group Assign an insight to a group `POST /ai/conversations/insight-groups/{group_id}/insights/{insight_id}/assign` ```go err := client.AI.Conversations.InsightGroups.Insights.Assign( context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", telnyx.AIConversationInsightGroupInsightAssignParams{ GroupID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", }, ) if err != nil { log.Fatal(err) } ``` ## Unassign Insight Template From Group Remove an insight from a group `DELETE /ai/conversations/insight-groups/{group_id}/insights/{insight_id}/unassign` ```go err := client.AI.Conversations.InsightGroups.Insights.DeleteUnassign( context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", telnyx.AIConversationInsightGroupInsightDeleteUnassignParams{ GroupID: "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", }, ) if err != nil { log.Fatal(err) } ``` ## Get Insight Templates Get all insights `GET /ai/conversations/insights` ```go page, err := client.AI.Conversations.Insights.List(context.Background(), telnyx.AIConversationInsightListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", page) ``` Returns: `created_at` (date-time), `id` (uuid), `insight_type` (enum: custom, default), `instructions` (string), `json_schema` (object), `name` (string), `webhook` (string) ## Create Insight Template Create a new insight `POST /ai/conversations/insights` — Required: `instructions`, `name` Optional: `json_schema` (object), `webhook` (string) ```go insightTemplateDetail, err := client.AI.Conversations.Insights.New(context.Background(), telnyx.AIConversationInsightNewParams{ Instructions: "You are a helpful assistant.", Name: "my-resource", }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", insightTemplateDetail.Data) ``` Returns: `created_at` (date-time), `id` (uuid), `insight_type` (enum: custom, default), `instructions` (string), `json_schema` (object), `name` (string), `webhook` (string) ## Get Insight Template Get insight by ID `GET /ai/conversations/insights/{insight_id}` ```go insightTemplateDetail, err := client.AI.Conversations.Insights.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", insightTemplateDetail.Data) ``` Returns: `created_at` (date-time), `id` (uuid), `insight_type` (enum: custom, default), `instructions` (string), `json_schema` (object), `name` (string), `webhook` (string) ## Update Insight Template Update an insight template `PUT /ai/conversations/insights/{insight_id}` Optional: `instructions` (string), `json_schema` (object), `name` (string), `webhook` (string) ```go insightTemplateDetail, err := client.AI.Conversations.Insights.Update( context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", telnyx.AIConversationInsightUpdateParams{}, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", insightTemplateDetail.Data) ``` Returns: `created_at` (date-time), `id` (uuid), `insight_type` (enum: custom, default), `instructions` (string), `json_schema` (object), `name` (string), `webhook` (string) ## Delete Insight Template Delete insight by ID `DELETE /ai/conversations/insights/{insight_id}` ```go err := client.AI.Conversations.Insights.Delete(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e") if err != nil { log.Fatal(err) } ``` ## Get a conversation Retrieve a specific AI conversation by its ID. `GET /ai/conversations/{conversation_id}` ```go conversation, err := client.AI.Conversations.Get(context.Background(), "conversation_id") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", conversation.Data) ``` Returns: `created_at` (date-time), `id` (uuid), `last_message_at` (date-time), `metadata` (object), `name` (string) ## Update conversation metadata Update metadata for a specific conversation. `PUT /ai/conversations/{conversation_id}` Optional: `metadata` (object) ```go conversation, err := client.AI.Conversations.Update( context.Background(), "conversation_id", telnyx.AIConversationUpdateParams{}, ) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", conversation.Data) ``` Returns: `created_at` (date-time), `id` (uuid), `last_message_at` (date-time), `metadata` (object), `name` (string) ## Delete a conversation Delete a specific conversation by its ID. `DELETE /ai/conversations/{conversation_id}` ```go err := client.AI.Conversations.Delete(context.Background(), "conversation_id") if err != nil { log.Fatal(err) } ``` ## Get insights for a conversation Retrieve insights for a specific conversation `GET /ai/conversations/{conversation_id}/conversations-insights` ```go response, err := client.AI.Conversations.GetConversationsInsights(context.Background(), "conversation_id") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", response.Data) ``` Returns: `conversation_insights` (array[object]), `created_at` (date-time), `id` (string), `status` (enum: pending, in_progress, completed, failed) ## Create Message Add a new message to the conversation. Used to insert a new messages to a conversation manually ( without using chat endpoint ) `POST /ai/conversations/{conversation_id}/message` — Required: `role` Optional: `content` (string), `metadata` (object), `name` (string), `sent_at` (date-time), `tool_call_id` (string), `tool_calls` (array[object]), `tool_choice` (object) ```go err := client.AI.Conversations.AddMessage( context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", telnyx.AIConversationAddMessageParams{ Role: "user", }, ) if err != nil { log.Fatal(err) } ``` ## Get conversation messages Retrieve messages for a specific conversation, including tool calls made by the assistant. `GET /ai/conversations/{conversation_id}/messages` ```go messages, err := client.AI.Conversations.Messages.List(context.Background(), "conversation_id") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", messages.Data) ``` Returns: `created_at` (date-time), `role` (enum: user, assistant, tool), `sent_at` (date-time), `text` (string), `tool_calls` (array[object]) ## Get Tasks by Status Retrieve tasks for the user that are either `queued`, `processing`, `failed`, `success` or `partial_success` based on the query string. Defaults to `queued` and `processing`. `GET /ai/embeddings` ```go embeddings, err := client.AI.Embeddings.List(context.Background(), telnyx.AIEmbeddingListParams{}) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", embeddings.Data) ``` Returns: `bucket` (string), `created_at` (date-time), `finished_at` (date-time), `status` (enum: queued, processing, success, failure, partial_success), `task_id` (string), `task_name` (string), `user_id` (string) ## Embed documents Perform embedding on a Telnyx Storage Bucket using an embedding model. The current supported file types are: - PDF - HTML - txt/unstructured text files - json - csv - audio / video (mp3, mp4, mpeg, mpga, m4a, wav, or webm ) - Max of 100mb file size. Any files not matching the above types will be attempted to be embedded as unstructured text. `POST /ai/embeddings` — Required: `bucket_name` Optional: `document_chunk_overlap_size` (integer), `document_chunk_size` (integer), `embedding_model` (object), `loader` (object) ```go embeddingResponse, err := client.AI.Embeddings.New(context.Background(), telnyx.AIEmbeddingNewParams{ BucketName: "my-bucket", }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", embeddingResponse.Data) ``` Returns: `created_at` (string), `finished_at` (string | null), `status` (string), `task_id` (uuid), `task_name` (string), `user_id` (uuid) ## List embedded buckets Get all embedding buckets for a user. `GET /ai/embeddings/buckets` ```go buckets, err := client.AI.Embeddings.Buckets.List(context.Background()) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", buckets.Data) ``` Returns: `buckets` (array[string]) ## Get file-level embedding statuses for a bucket Get all embedded files for a given user bucket, including their processing status. `GET /ai/embeddings/buckets/{bucket_name}` ```go bucket, err := client.AI.Embeddings.Buckets.Get(context.Background(), "bucket_name") if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", bucket.Data) ``` Returns: `created_at` (date-time), `error_reason` (string), `filename` (string), `last_embedded_at` (date-time), `status` (string), `updated_at` (date-time) ## Disable AI for an Embedded Bucket Deletes an entire bucket's embeddings and disables the bucket for AI-use, returning it to normal storage pricing. `DELETE /ai/embeddings/buckets/{bucket_name}` ```go err := client.AI.Embeddings.Buckets.Delete(context.Background(), "bucket_name") if err != nil { log.Fatal(err) } ``` ## Search for documents Perform a similarity search on a … ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [team-telnyx](https://github.com/team-telnyx) - **Source:** [team-telnyx/ai](https://github.com/team-telnyx/ai) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** yes - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-team-telnyx-ai-telnyx-ai-inference-go - Seller: https://agentstack.voostack.com/s/team-telnyx - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.