คำขอแรกใน Go ด้วย openai-go: base URL, คีย์, usage

คุณมีโค้ด Go ที่คุยกับ API สไตล์ OpenAI อยู่แล้ว หรือกำลังจะเขียนขึ้นมา หากต้องการส่งไปที่ CheapTokens คุณเพียงเปลี่ยนสองออปชันบนไคลเอนต์และสตริงหนึ่งตัว คือ model id ตัว SDK ยังคงเดิม: แพ็กเกจ openai-go อย่างเป็นทางการ เวอร์ชัน v3

ด้านล่างคือโปรแกรมทั้งหมด จากนั้นคือสิ่งที่แต่ละบรรทัดทำ วิธีอ่านคำตอบและจำนวนโทเค็น และวิธีป้องกันไม่ให้คำขอที่ค้างไปทำให้บริการของคุณค้าง เวอร์ชันตรวจสอบกับ README ของ openai-go เมื่อวันที่ 3 พฤศจิกายน 2026: แท็ก ล่าสุดบนหน้านั้นคือ v3.91.1 และต้องใช้ Go 1.26 ขึ้นไป

สิ่งที่ต้องมีก่อนเริ่ม#

• Go 1.26 ขึ้นไป บน Go 1.25 ให้ปัก v3.74.0; บน Go 1.22–1.24 ให้ปัก v3.44.0 (README ระบุว่าไลน์เก่าไม่ได้รับการรับประกันว่าจะมีแพตช์)
• API key ของ CheapTokens เก็บไว้ในตัวแปรสภาพแวดล้อม ไม่ใช่ในไฟล์ซอร์ส
• ที่อยู่ API: https://api.cheaptokens.dev/v1 รองรับรูปแบบ OpenAI Chat Completions ดังนั้น openai-go ใช้งานได้โดยไม่ต้องมีตัวห่อ เอกสาร มีที่อยู่เดียวกันและหน้ากุญแจ
• model id เราใช้ deepseek-ai/DeepSeek-V4-Flash-0731: คอนเท็กซ์ 380K และสูงสุด 32,768 โทเค็นในหนึ่งคำตอบ ใช้ id แบบเต็ม; ชื่อย่อจากตารางราคาจะไม่ถูกยอมรับโดย API

go mod init example.com/first-request
go get -u 'github.com/openai/openai-go/[email protected]'

export CHEAPTOKENS_API_KEY="paste-your-key-here"

โปรแกรมทั้งหมด#

package main

import (
	"context"
	"fmt"
	"log"
	"os"
	"time"

	"github.com/openai/openai-go/v3"
	"github.com/openai/openai-go/v3/option"
)

func main() {
	client := openai.NewClient(
		option.WithBaseURL("https://api.cheaptokens.dev/v1"),
		option.WithAPIKey(os.Getenv("CHEAPTOKENS_API_KEY")),
		option.WithMaxRetries(2),
		option.WithRequestTimeout(30*time.Second),
	)

	ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
	defer cancel()

	resp, err := client.Chat.Completions.New(ctx, openai.ChatCompletionNewParams{
		Model: "deepseek-ai/DeepSeek-V4-Flash-0731",
		Messages: []openai.ChatCompletionMessageParamUnion{
			openai.UserMessage("Explain in two sentences what a token is."),
		},
	})
	if err != nil {
		log.Fatal(err)
	}
	if len(resp.Choices) == 0 {
		log.Fatal("no choices in the response")
	}

	fmt.Println(resp.Choices[0].Message.Content)
	fmt.Println("finish_reason:", resp.Choices[0].FinishReason)
	fmt.Println("input tokens:", resp.Usage.PromptTokens)
	fmt.Println("output tokens:", resp.Usage.CompletionTokens)
	fmt.Println("total tokens:", resp.Usage.TotalTokens)
}

ส่วนที่สำคัญ:

• option.WithBaseURL(...) เป็นบรรทัดเดียวที่ย้าย SDK จาก OpenAI ไปยัง CheapTokens ใช้ที่อยู่ให้ตรงกับในเอกสาร
• option.WithAPIKey(os.Getenv(...)) ส่งคีย์อย่างชัดเจน หากไม่มี ไคลเอนต์จะอ่าน OPENAI_API_KEY ซึ่งมีประโยชน์เมื่อคุณพอร์ตโค้ดเดิม: ตั้งค่าตัวแปรนั้นเป็นคีย์ CheapTokens แล้วโค้ดไม่ต้องเปลี่ยนคีย์ เช่นเดียวกับ OPENAI_BASE_URL แต่ WithBaseURL ที่ระบุชัดเจนจะเขียนทับ ดังนั้นจึงไม่มีเรื่องเซอร์ไพรส์หากมีทั้งสอง
• Model เป็นสตริงธรรมดาใน SDK (ChatModel เป็นนามแฝงของ string) ดังนั้น model id ใดก็ใช้ได้ ไม่ใช่แค่ค่าคงที่ที่ README แสดง
• openai.UserMessage(...) คือหนึ่งเทิร์นของผู้ใช้ ตัวอย่างใน README ใช้ DeveloperMessage และค่าคงที่ GPT; ที่นี่ข้อความของผู้ใช้และ id แบบสตริงก็เพียงพอ

อ่านคำตอบ finish_reason และ usage#

ทั้งสามมาจากฟิลด์ที่ SDK แยกวิเคราะห์ให้แล้ว:

• resp.Choices[0].Message.Content คือข้อความ (string)
• resp.Choices[0].FinishReason ก็เป็น string เช่นกัน stop หมายความว่าโมเดลจบเอง; length หมายความว่าคำตอบชนขีดจำกัดโทเค็นและถูกตัด หากคุณเห็น length อ่าน ทำไมคำตอบจึงหยุดกลางประโยค
• resp.Usage เก็บ PromptTokens (สิ่งที่คุณส่ง), CompletionTokens (สิ่งที่โมเดลเขียน) และ TotalTokens ทั้งหมดเป็น int64

ผลลัพธ์จะมีลักษณะเช่นนี้: คำตอบ จากนั้น finish_reason: พร้อมค่า แล้วจำนวนโทเค็นสามค่า ตัวเลขจะต่างกันในทุกการรัน ดังนั้นให้บันทึกไว้ เป็นสิ่งที่คุณจ่าย และโทเค็นเอาต์พุตเป็นฝั่งที่แพงกว่า

การลองใหม่และไทม์เอาต์: ขีดจำกัดสามแบบที่ต่างกัน#

นี่คือจุดที่บริการ Go มักเจ็บปวด: โดยค่าเริ่มต้น SDK ไม่มีไทม์เอาต์เลย ดังนั้นการเชื่อมต่อที่หยุดชะงักอาจรอตลอดไป การตั้งค่าสามอย่างแก้ปัญหานี้ และทำงานในระดับที่ต่างกัน:

• option.WithMaxRetries(2): SDK ลองใหม่เมื่อเกิดข้อผิดพลาดการเชื่อมต่อ, 408, 409, 429 และ 5xx โดยรอแบบเอ็กซ์โพเนนเชียลสั้น ๆ สองครั้งเป็นค่าเริ่มต้นอยู่แล้ว; 0 ปิดการลองใหม่ คุณสามารถตั้งบนไคลเอนต์ หรือบนการเรียกครั้งเดียว
• option.WithRequestTimeout(30*time.Second): ขีดจำกัดสำหรับหนึ่งความพยายาม
• เดดไลน์ของ context: ขีดจำกัดสำหรับการเรียกทั้งหมด รวมถึงการลองใหม่และการรอ

ดังนั้นด้วยการลองใหม่ 2 ครั้งจึงมีความพยายามได้ถึง 3 ครั้ง: 3 × 30 = 90 วินาทีของการรอในกรณีเลวร้ายที่สุด บวกกับการหยุดพักสั้น ๆ ระหว่างความพยายาม คอนเท็กซ์สองนาทีครอบคลุมได้ หากคุณต้องการกฎเข้มงวดให้ตอบภายใน 20 วินาทีสำหรับเว็บแฮนด์เลอร์ ให้ย่อคอนเท็กซ์ ไม่ใช่แค่ไทม์เอาต์ต่อความพยายาม

สำหรับพื้นหลังที่ยาวขึ้นในการเลือกตัวเลขเหล่านี้ เวอร์ชัน Python ของคำแนะนำเดียวกันอยู่ใน OpenAI Python SDK timeout and retries ตรรกะใช้ได้กับ Go

การเรียกพันครั้งแบบนี้มีค่าใช้จ่ายเท่าไร#

สมมติคุณรันบริการเล็ก ๆ ที่ทำ 1,000 คำขอต่อวัน แต่ละครั้งมีอินพุตประมาณ 800 โทเค็นและเอาต์พุต 300 โทเค็น บน deepseek-ai/DeepSeek-V4-Flash-0731 วันนั้นมีค่าใช้จ่าย $0.042 (1,000 × 800 โทเค็นอินพุต, 1,000 × 300 โทเค็นเอาต์พุต) ตารางแสดงภาระเดียวกันในโมเดลของเรา; นับรวม อินพุตและเอาต์พุตรวมกัน ถูกกว่า OpenRouter

ใส่ตัวเลขของคุณเอง การรันครั้งแรกจะพิมพ์ PromptTokens และ CompletionTokens จริง ดังนั้นคุณไม่ต้องเดาค่าเฉลี่ย:

ราคาบนหน้าราคา และหน้ารุ่น เป็นแบบเรียลไทม์และใช้ราคาคงที่หนึ่งราคาต่อโมเดล โดยไม่มีช่วงพีค

หากใช้งานไม่ได้#

• ข้อผิดพลาดกล่าวถึง 401: คีย์ว่างหรือผิด os.Getenv คืนสตริงว่างสำหรับตัวแปรที่ไม่ได้ตั้งค่า ดังนั้นตรวจสอบ echo $CHEAPTOKENS_API_KEY ในเทอร์มินัลเดียวกับที่คุณรัน go run .
• ข้อผิดพลาดกล่าวถึง 404 หรือโมเดลไม่รู้จัก: id คัดลอกมาให้ครบ พร้อมคำนำหน้า deepseek-ai/ คุณสามารถแสดงรายการ id ได้ในการเรียกแสดงรายการโมเดล
• go: module requires Go 1.26: toolchain ของคุณเก่าเกินไป ปักแท็ก SDK เก่าตามที่แสดงด้านบน
• การเรียกค้างแล้วล้มเหลว: นั่นคือไทม์เอาต์ทำงาน ตรวจสอบเส้นทางเครือข่ายก่อน จากนั้นเพิ่ม WithRequestTimeout หากโมเดลต้องการเวลามากขึ้นจริง ๆ สำหรับคำตอบยาว

หากแนวคิด base URL เป็นเรื่องใหม่สำหรับคุณ base_url คืออะไรและวิธีสลับ อธิบายโดยไม่มีโค้ด