diff --git a/src/types/modrinth/create-version.ts b/src/types/modrinth/create-version.ts
index f8b38d9..34c53aa 100644
--- a/src/types/modrinth/create-version.ts
+++ b/src/types/modrinth/create-version.ts
@@ -1,12 +1,20 @@
 import { z } from "zod";
-import { BaseVersionSchema, FileTypeEnumSchema } from "./version";
+import {
+  BaseVersionSchema,
+  FileTypeEnumSchema,
+  VersionDependencySchema,
+} from "./version";
 
 // region CreatableVersion — 创建版本请求中的 data JSON
+// OpenAPI CreatableVersion.required: file_parts, project_id, name, version_number,
+//   game_versions, version_type, loaders, featured, dependencies
 export const CreatableVersionSchema = BaseVersionSchema.extend({
-  /** 目标项目的 ID（8 位 base62） */
-  project_id: z.string().length(8),
+  /** 目标项目的 ID */
+  project_id: z.string(),
   /** 所有承载文件的 multipart 字段名列表 */
   file_parts: z.array(z.string()),
+  /** 依赖列表。override BaseVersion 的 optional → required */
+  dependencies: z.array(VersionDependencySchema),
   /** 主文件的 multipart 字段名；不提供时推断第一个文件为主文件 */
   primary_file: z.string().optional(),
   /** 目标环境 */
diff --git a/src/types/modrinth/version.ts b/src/types/modrinth/version.ts
index a52729f..c5cf79e 100644
--- a/src/types/modrinth/version.ts
+++ b/src/types/modrinth/version.ts
@@ -40,29 +40,30 @@ export const VersionFileSchema = z.object({
   /** 文件哈希，包含 sha512 和 sha1 */
   hashes: VersionFileHashesSchema,
   /** 文件直链下载地址 */
-  url: z.string().url(),
+  url: z.string(),
   /** 文件名 */
   filename: z.string(),
   /** 是否为主文件。每版本最多一个主文件；若无则为第一个文件 */
   primary: z.boolean(),
   /** 文件大小（字节） */
-  size: z.number().int().min(0),
+  size: z.number().int(),
   /** 文件类型；普通主 jar 为 null */
   file_type: FileTypeEnumSchema.nullable(),
 });
 export type VersionFile = z.infer<typeof VersionFileSchema>;
 // endregion
 
-// region BaseVersion — 版本基础字段（Version 和 CreatableVersion 的公共基类）
+// region BaseVersion — 版本基础字段
+// OpenAPI BaseVersion 无 required 数组，以下按 "同时在两个子类都 required" 的字段设为必填
 export const BaseVersionSchema = z.object({
   /** 版本名称 */
   name: z.string(),
   /** 版本号，建议遵循语义化版本 */
   version_number: z.string(),
   /** 更新日志（Markdown/纯文本）；使用 include_changelog=false 时为 null */
-  changelog: z.string().nullable(),
-  /** 依赖列表 */
-  dependencies: z.array(VersionDependencySchema),
+  changelog: z.string().nullable().optional(),
+  /** 依赖列表。CreatableVersion 中必填，Version 响应中可选；子类通过 override 差异化 */
+  dependencies: z.array(VersionDependencySchema).optional(),
   /** 支持的 Minecraft 版本列表 */
   game_versions: z.array(z.string()),
   /** 发布渠道 */
@@ -72,25 +73,32 @@ export const BaseVersionSchema = z.object({
   /** 是否为精选版本 */
   featured: z.boolean(),
   /** 版本状态 */
-  status: z.enum(["listed", "archived", "draft", "unlisted", "scheduled"]),
+  status: z
+    .enum(["listed", "archived", "draft", "unlisted", "scheduled", "unknown"])
+    .default("listed"),
   /** 请求的状态（用于审核流程） */
-  requested_status: z.enum(["listed", "archived", "draft", "unlisted"]).nullable(),
+  requested_status: z
+    .enum(["listed", "archived", "draft", "unlisted"])
+    .nullable()
+    .optional(),
 });
 export type BaseVersion = z.infer<typeof BaseVersionSchema>;
 // endregion
 
-// region Version — 版本完整响应体（GET /version/{id}、GET /project/{id}/version 等返回）
+// region Version — 版本完整响应体
+// OpenAPI Version.required: id, project_id, author_id, date_published, downloads, files,
+//   name, version_number, game_versions, version_type, loaders, featured
 export const VersionSchema = BaseVersionSchema.extend({
   /** 版本唯一 ID（8 位 base62） */
-  id: z.string().length(8),
-  /** 所属项目 ID（8 位 base62） */
-  project_id: z.string().length(8),
+  id: z.string(),
+  /** 所属项目 ID */
+  project_id: z.string(),
   /** 发布者用户 ID */
   author_id: z.string(),
   /** 发布时间（ISO-8601） */
-  date_published: z.string().datetime(),
+  date_published: z.string(),
   /** 下载次数 */
-  downloads: z.number().int().min(0),
+  downloads: z.number().int(),
   /** changelog URL（已废弃，始终为 null） */
   changelog_url: z.string().nullable(),
   /** 该版本的所有文件列表 */