اتصال Go به پیکو هوش

در Go رایج‌ترین کتابخانه‌ی جامعه برای API سازگار با OpenAI بسته‌ی github.com/sashabaranov/go-openai است. این بسته یک ساختار پیکربندی دارد که فیلد BaseURL آن را می‌توان تغییر داد، پس اتصال به پیکو هوش چند خط بیشتر نیست.

اگر نمی‌خواهید وابستگی اضافه کنید، net/http استاندارد هم کافی است؛ API فقط JSON روی HTTPS است.

پیش‌نیازها

• یک حساب پیکو هوش و یک کلید API از داشبورد (کلید فقط یک‌بار کامل نمایش داده می‌شود).
• شناسه‌ی دقیق مدل از کاتالوگ؛ در مثال‌ها از gpt-6-sol و claude-sonnet-5-5 استفاده شده است.
• کمی موجودی در کیف پول تومانی یا اعتبار؛ تعرفه را در صفحه‌ی قیمت‌ها ببینید.

راه‌اندازی گام‌به‌گام

1. ۱نصب ماژول

   ماژول را در پروژه‌ی Go اضافه کنید.

   کپی

   go get github.com/sashabaranov/go-openai

2. ۲ساخت کلاینت با BaseURL

   ابتدا DefaultConfig بسازید و BaseURL را عوض کنید.

   کپی

   package main
   
   import (
   	"context"
   	"fmt"
   	"os"
   
   	openai "github.com/sashabaranov/go-openai"
   )
   
   func main() {
   	cfg := openai.DefaultConfig(os.Getenv("PICOAI_API_KEY"))
   	cfg.BaseURL = "https://api.picoai.ir/v1"
   	client := openai.NewClientWithConfig(cfg)
   
   	resp, err := client.CreateChatCompletion(context.Background(), openai.ChatCompletionRequest{
   		Model: "gpt-6-sol",
   		Messages: []openai.ChatCompletionMessage{
   			{Role: openai.ChatMessageRoleUser, Content: "سلام!"},
   		},
   	})
   	if err != nil {
   		panic(err)
   	}
   	fmt.Println(resp.Choices[0].Message.Content)
   }

3. ۳بدون وابستگی با net/http

   برای سرویس‌های کوچک می‌توانید ساختار JSON را خودتان بسازید.

   کپی

   body := []byte(`{"model":"gpt-6-sol","messages":[{"role":"user","content":"سلام"}]}`)
   req, _ := http.NewRequest("POST", "https://api.picoai.ir/v1/chat/completions", bytes.NewReader(body))
   req.Header.Set("Authorization", "Bearer "+os.Getenv("PICOAI_API_KEY"))
   req.Header.Set("Content-Type", "application/json")
   res, err := http.DefaultClient.Do(req)

4. ۴استریم

   متد CreateChatCompletionStream رویدادها را یکی‌یکی می‌دهد؛ با Recv بخوانید تا io.EOF برسد.

   کپی

   stream, err := client.CreateChatCompletionStream(ctx, openai.ChatCompletionRequest{
   	Model: "gpt-6-sol", Stream: true,
   	Messages: []openai.ChatCompletionMessage{{Role: "user", Content: "شمارش تا ۵"}},
   })
   if err != nil { panic(err) }
   defer stream.Close()
   for {
   	r, err := stream.Recv()
   	if errors.Is(err, io.EOF) { break }
   	if err != nil { panic(err) }
   	fmt.Print(r.Choices[0].Delta.Content)
   }

تست سریع اتصال

پیش از نوشتن منطق برنامه، یک بار فهرست مدل‌ها را بگیرید. اگر پاسخ ۲۰۰ و فهرستی از شناسه‌ها برگشت، کلید، شبکه و آدرس درست است و هر مشکل بعدی مربوط به تنظیمات Go خواهد بود.

curl https://api.picoai.ir/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

نکته‌های کاربردی برای Go

• context با timeout بدهید (context.WithTimeout) تا درخواست‌های گیرکرده منابع را اشغال نکنند.
• http.Client سفارشی را از طریق cfg.HTTPClient بدهید تا پراکسی و Transport را کنترل کنید.
• نام فیلدهای بسته ممکن است در نسخه‌های جدید تغییر کند؛ نسخه را در go.mod ثابت نگه دارید.

عیب‌یابی

هزینه و صورتحساب

هر درخواست قبل از اجرا مقداری از موجودی را رزرو می‌کند و پس از پاسخ موفق بر پایه‌ی توکن‌های واقعی تسویه می‌شود؛ مابه‌التفاوت برمی‌گردد و درخواست ناموفق چیزی کم نمی‌کند. جدول قیمت هر مدل در صفحه‌ی قیمت‌ها منتشر شده و مصرف هر درخواست در داشبورد قابل مشاهده است. اگر قبلاً از سرویس دیگری استفاده می‌کردید، راهنمای مهاجرت و صفحه‌ی مقایسه را ببینید.