1. 从 iOS 到 Android为什么首页数据请求要统一走一个 Key如果你已经用 Cursor 把 Android 项目骨架搭起来了接下来大概率会卡在同一个地方首页要展示数据数据从哪来是自己写个假数据先顶着还是直接接真实接口我建议一开始就把网络层接好因为后面模板管理、计数记录、设置同步都会复用同一套请求通道。问题在于很多人在这一步会陷入“每个模型厂商注册一个账号、每个账号配一个 Key”的泥潭。Cursor 帮你写代码很快但 Key 管理是它替不了的。你需要在项目里维护一堆 baseUrl、apiKey、model 名称改一个地方要翻好几个文件。更麻烦的是Android 项目里 Key 一旦硬编码进 BuildConfig打包出去就有泄露风险。TaoToken 在这里的价值就很直接它提供一个统一的 API 通道你只需要在项目里配置一个 baseUrl 和一个 Key就能调用多种模型。对于 Android APP 这种需要长期迭代、可能接入多个 AI 能力的场景统一 Key 意味着网络层只需要写一次后面换模型、加功能都不用动架构。这篇要做的三件事第一把 Kotlin Jetpack Compose 的项目骨架补上网络依赖第二用 TaoToken 的统一 Key 配置 Retrofit第三写一个首页 Compose 组件真实发起一次请求并渲染结果。全程可以在 Android Studio 里跟做Cursor 负责生成代码你负责确认配置。适合谁看已经用 Cursor 创建了 Android 项目、能跑起 Hello World、但还没接网络层的开发者。不需要你精通 Kotlin 协程但至少要能看懂 suspend 函数和 StateFlow。2. TaoToken 前置拿 Key、选通道、确认 baseUrl在写代码之前先把 TaoToken 这边的准备工作做完。这一步不涉及 Android 代码但决定了后面配置能不能一次通。首先打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进入控制台找到 API Keys 页面创建一个新的 Key。建议给这个 Key 起一个能识别的名字比如android-bunnytally-dev这样后面如果要在多个项目里用不会搞混。创建完 Key 之后复制保存好。注意Key 只在创建时完整显示一次关掉页面就看不到了。如果你不小心关了直接删掉重新建一个就行不要试图找回。接下来确认 API 地址。TaoToken 的 API 入口是 https://taotoken.net/api 这个地址后面要填到 Retrofit 的 baseUrl 里。注意 baseUrl 必须以/结尾否则 Retrofit 会报IllegalArgumentException。所以实际写的时候是https://taotoken.net/api/。关于模型选择首页演示用一个响应快、成本低的模型就够了。你可以在模型对话页面先手动试一条请求确认 Key 和通道都正常。模型对话入口在这里 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。在页面里选一个模型发一句“你好”如果能正常返回说明 Key 和通道没问题。如果你后面打算长期用 Cursor 做编码、或者要接 Agent 类功能可以了解一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。它适合需要频繁调用、对额度有稳定预期的场景。首页这种轻量请求用按量计费就够了不用一上来就上套餐。注意Key 不要写进代码里提交到 Git。后面我们会用local.properties或者环境变量的方式管理确保仓库里看不到明文 Key。3. 可复制配置build.gradle.kts 依赖与网络层骨架现在回到 Android Studio。打开你的项目找到app/build.gradle.kts。如果你是用 Cursor 生成的骨架依赖部分可能只有 Compose 基础库。我们需要补上 Retrofit、OkHttp、Kotlin 序列化或者 Gson、协程和 ViewModel 相关依赖。下面这段可以直接复制到dependencies块里。版本号我用的是写这篇文章时比较稳定的组合你可以根据 Android Studio 的提示微调dependencies { // 已有的 Compose 依赖保留 implementation(androidx.core:core-ktx:1.12.0) implementation(androidx.lifecycle:lifecycle-runtime-ktx:2.6.2) implementation(androidx.activity:activity-compose:1.8.2) implementation(androidx.compose.ui:ui:1.6.7) implementation(androidx.compose.material3:material3:1.2.1) implementation(androidx.compose.ui:ui-tooling-preview:1.6.7) implementation(androidx.lifecycle:lifecycle-viewmodel-compose:2.6.2) // 网络层 implementation(com.squareup.retrofit2:retrofit:2.11.0) implementation(com.squareup.retrofit2:converter-gson:2.11.0) implementation(com.squareup.okhttp3:okhttp:4.12.0) implementation(com.squareup.okhttp3:logging-interceptor:4.12.0) // 协程 implementation(org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.0) // 如果你用 Hilt保留原来的 Hilt 依赖 // implementation(com.google.dagger:hilt-android:2.51.1) // kapt(com.google.dagger:hilt-android-compiler:2.51.1) }这里我故意没有把 Hilt 写死因为首页数据请求不一定需要依赖注入。如果你项目里已经配了 Hilt可以把网络模块做成Module提供如果还没配直接用单例对象管理 Retrofit 实例更简单少一层学习成本。接下来处理 Key 的存放。在项目根目录的local.properties里加一行TAOTOKEN_API_KEY你的Key粘贴在这里然后在app/build.gradle.kts的android块外面读取这个值并注入 BuildConfigimport java.util.Properties val localProperties Properties().apply { val file rootProject.file(local.properties) if (file.exists()) { file.inputStream().use { load(it) } } } android { // ... 其他配置 buildFeatures { compose true buildConfig true } defaultConfig { // ... 其他配置 buildConfigField( String, TAOTOKEN_API_KEY, \${localProperties.getProperty(TAOTOKEN_API_KEY) ?: }\ ) } }这样代码里通过BuildConfig.TAOTOKEN_API_KEY就能拿到 Key而local.properties默认在.gitignore里不会提交。现在写网络层。新建一个文件data/remote/TaoTokenApi.ktpackage com.example.bunnytally.data.remote import retrofit2.http.Body import retrofit2.http.Header import retrofit2.http.POST data class ChatRequest( val model: String, val messages: ListMessage ) data class Message( val role: String, val content: String ) data class ChatResponse( val choices: ListChoice ) data class Choice( val message: Message ) interface TaoTokenApi { POST(v1/chat/completions) suspend fun chat( Header(Authorization) auth: String, Body request: ChatRequest ): ChatResponse }再写一个单例提供 Retrofit 实例文件data/remote/RetrofitClient.ktpackage com.example.bunnytally.data.remote import com.example.bunnytally.BuildConfig import okhttp3.OkHttpClient import okhttp3.logging.HttpLoggingInterceptor import retrofit2.Retrofit import retrofit2.converter.gson.GsonConverterFactory import java.util.concurrent.TimeUnit object RetrofitClient { private const val BASE_URL https://taotoken.net/api/ private val okHttpClient OkHttpClient.Builder() .connectTimeout(30, TimeUnit.SECONDS) .readTimeout(60, TimeUnit.SECONDS) .addInterceptor( HttpLoggingInterceptor().apply { level HttpLoggingInterceptor.Level.BASIC } ) .build() val api: TaoTokenApi by lazy { Retrofit.Builder() .baseUrl(BASE_URL) .client(okHttpClient) .addConverterFactory(GsonConverterFactory.create()) .build() .create(TaoTokenApi::class.java) } fun authHeader(): String Bearer ${BuildConfig.TAOTOKEN_API_KEY} }注意 baseUrl 结尾的/和接口路径v1/chat/completions拼接后是https://taotoken.net/api/v1/chat/completions这是正确的。如果你漏了结尾斜杠Retrofit 会直接抛异常这是新手最容易踩的坑之一。4. 首页 Compose 组件与一次真实请求验证网络层有了现在写首页。新建ui/home/HomeViewModel.ktpackage com.example.bunnytally.ui.home import androidx.lifecycle.ViewModel import androidx.lifecycle.viewModelScope import com.example.bunnytally.data.remote.ChatRequest import com.example.bunnytally.data.remote.Message import com.example.bunnytally.data.remote.RetrofitClient import kotlinx.coroutines.flow.MutableStateFlow import kotlinx.coroutines.flow.StateFlow import kotlinx.coroutines.launch data class HomeUiState( val loading: Boolean false, val content: String , val error: String? null ) class HomeViewModel : ViewModel() { private val _uiState MutableStateFlow(HomeUiState()) val uiState: StateFlowHomeUiState _uiState fun fetchGreeting() { _uiState.value HomeUiState(loading true) viewModelScope.launch { try { val response RetrofitClient.api.chat( auth RetrofitClient.authHeader(), request ChatRequest( model gpt-4o-mini, messages listOf( Message(role user, content 用一句话介绍番茄计数法) ) ) ) val text response.choices.firstOrNull()?.message?.content ?: 返回为空 _uiState.value HomeUiState(content text) } catch (e: Exception) { _uiState.value HomeUiState(error e.message ?: 未知错误) } } } }这里模型名我写的是gpt-4o-mini你可以换成 TaoToken 模型对话页面里确认可用的任意模型名。如果模型名不对接口会返回错误错误信息会显示在首页上方便排查。然后写ui/home/HomeScreen.ktpackage com.example.bunnytally.ui.home import androidx.compose.foundation.layout.Arrangement import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.fillMaxSize import androidx.compose.foundation.layout.padding import androidx.compose.material3.Button import androidx.compose.material3.CircularProgressIndicator import androidx.compose.material3.MaterialTheme import androidx.compose.material3.Text import androidx.compose.runtime.Composable import androidx.compose.runtime.collectAsState import androidx.compose.runtime.getValue import androidx.compose.ui.Alignment import androidx.compose.ui.Modifier import androidx.compose.ui.unit.dp import androidx.lifecycle.viewmodel.compose.viewModel Composable fun HomeScreen(viewModel: HomeViewModel viewModel()) { val state by viewModel.uiState.collectAsState() Column( modifier Modifier .fillMaxSize() .padding(24.dp), verticalArrangement Arrangement.Center, horizontalAlignment Alignment.CenterHorizontally ) { Text( text BunnyTally 首页, style MaterialTheme.typography.headlineMedium ) when { state.loading - { CircularProgressIndicator(modifier Modifier.padding(16.dp)) } state.error ! null - { Text( text 请求失败${state.error}, color MaterialTheme.colorScheme.error, modifier Modifier.padding(16.dp) ) } state.content.isNotEmpty() - { Text( text state.content, style MaterialTheme.typography.bodyLarge, modifier Modifier.padding(16.dp) ) } } Button( onClick { viewModel.fetchGreeting() }, modifier Modifier.padding(top 16.dp) ) { Text(请求 TaoToken) } } }最后在MainActivity.kt里调用package com.example.bunnytally import android.os.Bundle import androidx.activity.ComponentActivity import androidx.activity.compose.setContent import com.example.bunnytally.ui.home.HomeScreen class MainActivity : ComponentActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContent { HomeScreen() } } }现在点 Android Studio 顶部的 Run。应用启动后首页会显示一个按钮。点一下按钮如果配置正确你会看到 loading 转圈然后显示模型返回的一句话。这就是一次完整的接口连通性验证。如果你在 Logcat 里看到-- POST https://taotoken.net/api/v1/chat/completions和-- 200 OK说明请求已经通了。如果看到 401说明 Key 没读到或者格式不对如果看到 404检查 baseUrl 和路径拼接。5. 本篇常见错排查从 401 到编译不过这一节把首页接通过程中最容易遇到的几个问题集中列一下方便你对照排查。问题一BuildConfig.TAOTOKEN_API_KEY 为空现象是请求返回 401Logcat 里 Authorization 头是Bearer后面空的。原因是local.properties没读到或者buildConfigField没生效。检查两点第一local.properties是否在项目根目录不是 app 目录第二改完 gradle 后有没有点 Sync。如果还不行在build.gradle.kts里加一句println(Key length: ${localProperties.getProperty(TAOTOKEN_API_KEY)?.length})Sync 时看 Build 窗口有没有输出长度。问题二Retrofit baseUrl 报 IllegalArgumentException错误信息通常是baseUrl must end in /。检查RetrofitClient里的BASE_URL确认是https://taotoken.net/api/结尾有斜杠。这个错误在编译期不会出现只有运行时创建 Retrofit 实例才会抛所以容易漏。问题三Unresolved reference: BuildConfig如果你在RetrofitClient里引用BuildConfig报红说明buildConfig true没开。在android块的buildFeatures里加上buildConfig true然后 Sync。另外确认 import 的是你自己包名的 BuildConfig不是其他模块的。问题四请求超时或连接失败先确认设备网络正常。然后检查OkHttpClient的超时设置首页请求我设了 connect 30 秒、read 60 秒一般够用。如果还是超时在模型对话页面手动发一条请求确认 Key 本身可用。如果手动可以、代码不行大概率是 baseUrl 或路径拼接问题。问题五Cursor 改了代码但 Android Studio 没同步这个在上一篇文章里也遇到过。Cursor 和 Android Studio 同时打开同一个项目时Studio 不一定能实时感知外部改动。解决办法是在 Studio 里点 File Synchronize或者直接关掉文件重新打开。如果还不行重启 Studio。建议同一时间只用一个编辑器改代码避免冲突。问题六模型名不存在返回 400不同通道支持的模型名可能不一样。如果你填的模型名在 TaoToken 这边不可用接口会返回错误。最稳妥的方式是先去模型对话页面确认当前可用的模型名再填到代码里。首页演示用一个轻量模型即可不用追求最强模型。提示如果你在排障过程中需要确认 Key 状态或重新生成直接去 API Keys 页面操作 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。接入相关的完整说明在文档里 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。6. 下一步把首页请求模式复制到其他页面首页跑通之后你其实已经拥有了一个可复用的网络请求模板。后面做模板管理、计数记录、设置同步都可以照这个模式来ViewModel 里发请求、StateFlow 暴露状态、Compose 组件根据状态渲染。区别只是接口路径和请求体不同。如果你打算继续用 Cursor 生成后续页面建议把这一篇里的RetrofitClient、TaoTokenApi、HomeViewModel三个文件作为上下文喂给它让它理解你的网络层约定。这样它生成的代码不会又给你塞一套新的 Retrofit 配置避免项目里出现两套网络层。对于需要长期编码、频繁调用模型的场景可以看看 Coding Plan 是否适合你的使用节奏 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。首页这种按需请求用按量计费就够等你的 APP 真正需要批量生成内容或者接 Agent 时再考虑套餐。最后提醒一句Key 的管理从第一天就要规范。local.properties只适合本地开发如果后面要接 CI 或者多人协作记得把 Key 放到环境变量或者密钥管理服务里不要图省事直接写进代码。首页能跑通只是开始网络层的整洁程度决定了你后面加功能时有多轻松。
