# API Early Access - Office Hours

## Метаданные

- **Канал:** Descript
- **YouTube:** https://www.youtube.com/watch?v=gfhW_tVJRDg
- **Дата:** 18.04.2026
- **Длительность:** 33:41
- **Просмотры:** 98

## Описание

Weekly API support with the Descript Team

## Содержание

### [0:00](https://www.youtube.com/watch?v=gfhW_tVJRDg) Segment 1 (00:00 - 05:00)

[clears throat] — Um um emulate the taste of like non-chicken nuggets. — So, these nuggets are made from chicken, but they're made to emulate the taste of non-chicken nuggets. Dope. — Oh, that's much better. Edit all the blather out of your videos because my time is very precious. — Oh, that's fire. Make it less teal and more cerulean. Sure. Replace your background with something more fun. Cold void about her space. Let's boost that sound quality. Emulate the taste of non-chicken nuggets. Emulate the taste of non-chicken nuggets. Dope. It needs more style. It needs more clips, more gifts, more more. Well, I might have made it too gnarly. — Welcome. Descript API office hours are in session. I am your co-host Aaron, joined by Teddy. Teddy, how's it going today? It's good. It's a beautiful Friday here in the Bay Area. Hope it's good where you are. I shoveled 6 in of snow, so guessing a little different than what you have, but Yes, the Bay Area was nice. I was there this week and it was not too hot. I missed the rain. I think it rained a lot over the weekend, but Yeah, such is life. Well, we are working on automating your video production with the Descript API and you are either interested in getting it going or maybe you've been using it and have some feedback, ideas, blockers that you've hit. And we would love to hear what those are so that Teddy can address them. Most I think everybody's on YouTube today. Gabe, shout out Gabe in the chat, is going to help you if there's any links or reference materials for your questions on the help center or the API docs. And we will make sure you get taken care of. Teddy, let's just start with what's the purpose of a Descript API because I can go to descript. com and edit in the browser app or the desktop app. Why do I need an API? So, this is a great question. The big thing that makes the API beneficial is it lets you bring Descript wherever you want to be. So, for example, if you do all your work in Claude or ChatGPT, it lets you bring Descript as one of your tools that Claude or ChatGPT can pull from. If you're somebody who you're writing a little web application and you want to incorporate video editing in some way into your web application, you can bring Descript into that. Or if you even want to use Zapier to make little apps so that you're on the road and you're recording some footage with your um iPhone camera, you can just email that to you and then Zapier will pull that into Descript so that by the

### [5:00](https://www.youtube.com/watch?v=gfhW_tVJRDg&t=300s) Segment 2 (05:00 - 10:00)

time you get home, you're ready to start editing. And it really the point of the API is to just unlock Descript to let you bring it everywhere you want and have more purposes that you can use it for rather than being tied to sitting at your computer on Descript web to do anything. Yeah, that's a really cool use case to email videos or images from your trip and then when you get home, you have a Descript project with all of them in the project files laid out and then you can just fine-tune, edit, and finish it. Exactly. Yeah. Well, if you are in the chat, anytime we cover something that you want to see or have a question on, we will address that. There's no slide deck today. We are going to demo and walk through a few things. Something else that we get asked a lot is does it work with this LLM or app? If you can give it the API and say, "Here's a link to it, use it. " The answer is yes. But if you are in an ecosystem, let's say you use Claude desktop app for a lot of your work. We'd love to know what you're using and then we can tell you, "Here's the most streamlined way to get that talking to the Descript API. " So, should we walk through one of those, whether it's like the setup or where do I start if I want to use some of these things that you just talked about, Teddy? Yeah, let's walk through the setup. So, I can show you all how to get set up. I'm going to demo Claude, but the steps are virtually the same if you're using Codex, ChatGPT, any AI tool that allows you to add a custom MCP. Um so, what I'm going to do in Claude is I'm going to go here to customize. And then on this left bar, I have connectors. And from here, I'm going to click this plus sign and add a custom connector. And hopefully in the near future, we will be listed just like any other app in the Anthropic marketplace, but for now while we're in this beta period, we're a custom connector. So, you're going to click add custom connector here. And I'm going to put the name as Descript. And then I'm going to cup copy and paste the remote MCP server URL over here. This you can find in our help center docs on how to get set up with the API. But just to read it out loud, it's api. descript. com/v2/mcp. And you don't need to worry about any of the advanced settings here. And when I click add, whoopsie doodle, this happens sometimes. This is an issue we're working out with Anthropic where it loads and says the connector has no tools available. The fix here is really simple. I'm just going to click disconnect. And then reconnect. And that bounced me to a web page over here to connect with the Descript MCP. So, by clicking this allow button, this is what hooks up Claude to my Descript account. And what the drive that will get connected to Claude is whatever drive you currently have selected in descript. com. So, if you want to change your drive, this is the point where you should do that. But if you decide later you want to change your drive, that's okay. You can just disconnect and reconnect. So, I'm happy with the drive I have selected now, so I'm going to click allow. And then it'll take me back to Claude. And once you get to this screen where you see that you have all these tools and their permissions, that's how you know you're successfully connected. And you can select your permissions however you want. I like to have always allow because I don't personally want to be babysitting Claude and having to okay everything Claude does. I trust Claude, but I know other people have different preferences and that's okay. And one thing you might notice here that's new is when we first started these office hours, the only tools here were underlord and import media. But now we've got a bunch of other options, too. So, now Claude can actually contact Descript to list what jobs are active. So, what edits you're currently doing, it can list projects, it can get projects, and it can also publish projects. These are all new and they're beta features, so please feel free to try them out. Let them Let us know how it works for you or if it doesn't work. But yeah, we're excited to have those. And then from there, I can just chat with Claude. I can say, "Make me a 2-minute video about whether Chihuahuas or Pomeranians are the better dog in Descript. " Ooh. I've not seen this one before. This model isn't available right now. I guess that's because I'm on a cheap plan. I'm going to try one of the cheaper ear models and let's see if Claude lets me

### [10:00](https://www.youtube.com/watch?v=gfhW_tVJRDg&t=600s) Segment 3 (10:00 - 15:00)

do that. Okay. So, that's just cuz I'm on a free account right now on my personal account. But then I can also, if we're interest if anyone's interested, I can also switch to my Descript account to give kind of a sneak preview of other things we've got cooking in the MCP later on. But yeah, so you can see here in the Claude window, Claude is actively talking to Descript now. And one thing that's pretty cool is if I go to Descript web and look at my projects, I can see Claude's actually already created a project. And in here, this will probably be pretty slow, so it won't be too exciting, but hypothetically I could keep this window open and just watch Claude do the edits and like my hands are right here. I'm not doing anything. It's all Claude doing running the show. And that little animation in Claude is new as well, isn't it? Mhm, this is new. We've just implemented these prod progress bars cuz we know it can be frustrating when you're waiting in Claude and wondering how long is this taking. Are things actually done or not, you know? So, we're currently experimenting with these, tweaking them a little bit to see what's the best way to communicate like yes, we're still working on things or oops, we got stuck to users, but right now I like the progress bars. They're very hot off the presses. And I like too that over here, they give you a way to open the project in Descript directly as well. So, yeah. So, what do you think the default is if you tell it to create the video? Is it going to do AI generated video or find B-roll or is that part of just using an LLM is you never really [clears throat] know. If you didn't tell it exactly how to do it, it'll just pick away. Yeah, so this is a great question. What I notice is that by default it'll usually write me a script and it'll assign an AI speaker. Claude can be like hot and cold about whether or not it'll actually make visual assets assigned to the video. So, sometimes I'll look at my project and be like, hey, there's like no video in here. And then I go back to Claude and I'm like, please add some videos. Use B-roll or from our stock footage library or make some videos. And sometimes Claude does that unprompted. So, don't be worried if you open your project and you're like, where's the media? Um, Claude just forgot and you need to prompt him again. Um, but then also what you can do is Claude is smart enough and under to work with Underlord and if you have a active project already that you want to work in, you can tell Claude, I want to make these edits to this project and use this media. So, I could actually start another chat like that. — [snorts] — Let's take this video I made on how to make caramel because I made the milk bar pumpkin pie for Thanksgiving and it was my first time making caramel. And I'm going to let Claude keep working on that and in the meantime, I'm going to do a new chat in this project in Descript. I want you to use my media in media library more feature my recordings in a nice way and move out and add some stock music. And we should hopefully see that Claude and Underlord get it. But if they don't, that'll be interesting to see what they do come up with. Yeah, and you mentioned Claude and Underlord. So, TD on YouTube is asking about the credit usage cuz this is a little bit different. You have the Claude plan side or whatever AI tool you're using and then you have the Descript Underlord side. How should people using the API think about credits? Mhm. That's a great question, one that comes up really often. So, the idea is you've got Claude talking to Underlord right now. So, anything Claude does in the Claude world when I'm in my Claude app, anything I type to Claude, that's going to cost me tokens with Claude. But anything Claude tells Underlord to do, if that would cost you AI credits to do it yourself in app, it'll still in Claude. And then the common follow-up is why should I use Claude then? Why do I because that sounds like more tokens?

### [15:00](https://www.youtube.com/watch?v=gfhW_tVJRDg&t=900s) Segment 4 (15:00 - 20:00)

And my personal answer is that I think sometimes Claude is better at prompting Underlord than I am. Claude comes up with better project plans than I do. And so, for me it's worthwhile to use the extra tokens to have Claude there to help me. But anything that you can do in Underlord and that costs you credits will still cost you credits if you use Claude or another ear LLM to help you out there. Yeah, and I would add whatever context you have connected to your LLM. You might have a project file or a bunch of uploaded transcripts for your podcast. Mhm. Those things can now talk to a specific Descript project that you couldn't really do before without the API. Mhm, exactly. And like especially if you're somebody who really likes using Claude co-work and you have a workspace set up that has say all your footage, all your B-roll and some of it's located in Google calendar, some's on your desktop on your computer, some's already in Descript. The benefit of spending those Claude tokens is being able to have Claude look at the big picture of everything and then tell Underlord what's best so that hopefully you're actually using fewer media minutes and fewer Underlord tokens because you already have this pre this pre-step of you know, to use a cooking analogy, you're not going to the grocery store and buying all the vegetables and then realizing, oh, I only needed bell peppers for my recipe. You're actually looking at your recipe beforehand and saying, okay, I'm just going to go buy the red bell peppers and then you've spent less at the store overall. Yeah, that's a great analogy. So, what do you think it came up with here? Okay, so let's see. So, it looks like it found a screen recording I made and I haven't used it at all, so it's going to find a place to slide that in. It also found some unused AI assets I generated and it's going to find a way to use that. I actually really like that because it personally irks me as somebody who, not to keep going with the grocery store analogy, but — who really likes to get the best bang for my buck when I spend credits on something and I don't actually end up using it. So, it's nice that Claude's being like, hey, you want to use this? Um, and then it found some other stock video that I guess past me liked but forgot to actually add to my video at some point. So, in these places where my avatar in the video is not present for a long stretch, it's just going to slide my video in there. Yeah, so it basically looked in your project files and then referenced what was on the timeline and said you have some things over here that you've made or or downloaded but didn't put into your project. — Mhm, exactly. And you can see actually right now it's also adding some music like I requested. So, I'm excited to hear what tropical elevators sounds like. — [sighs] — Yeah, and sometimes it's more fun. I will have Underlord find music and just tell it a vibe because one of the tough things with using a media library manually is if you don't know the name of it, it's hard to find. And sometimes you say, this is the scene and maybe the feeling I want, you go find me three different ones. Right. Often does better than I could have done manually. Mhm. [clears throat] And like one thing I think a lot about is when we look at, for example, we have this great stock media library in Descript that we can use. And for me when I'm thinking, I want a whoosh sound, these images and assets all have all these different kinds of tags and under the tools that LL under the hood that LLMs and other tools can pull. So, when I type, for example, that I want a blue sky, that's how search knows to pull it. But sometimes there's things that I'm not actually I don't know what the specific tag is, but if I can kind of brainstorm with Claude a little bit about this is the vibe I want, then sometimes Claude is able to zero in on what actually I want because Claude just sees more information than I do. So, yeah, we can see, okay, at 41 to 47, we'll get to find out what my screen recording was that I forgot to include. Okay. Oh, I see. My screen recording is me searching for a bit of Great British Bake Off footage on that time in caramel week where everybody burnt their caramel because that was my fear when I was making caramel. And that was why I made this video. And then we can see at 30 to 33, there should be some stuff around sugar. So, let's see. And there we go. So, now you can see actually the

### [20:00](https://www.youtube.com/watch?v=gfhW_tVJRDg&t=1200s) Segment 5 (20:00 - 25:00)

filmstrip is updating live while I So, what we saw previously there was this stock footage of caramel just kind of swirling around. And now instead, Underlord has decided that some footage of sugar would be better here. So, yeah. And then we can check too on our other one. Uh-oh. I guess Claude is having struggle with my Chihuahuas versus Pomeranians debate. Maybe that triggered some kind of big internal struggle of Claude. But, if we look at the Descript project, we can see that Oh, it looks like Claude had a real goof up here. Because this appears to be like the script is about Chihuahua, but all the footage is about like Mediterranean living. So, I don't know what that what that's about, but that's the perils of working with LLM sometimes. Is sometimes it you hit it right off and sometimes it doesn't work. So, caramel, yes. Chihuahuas versus Pomeranians, apparently too big for Claude. Yeah, true to the Teddy style of wasn't the other one about hot dogs being a sandwich, yes or no? Yes, and last week I did is does coffee count as soda because it has caffeine and that generated some spicy opinions than I was expecting. I've never heard that one, but I would think because of the carbonation it's not Maybe that's not inherently part of a soda's definition. But, see you can sometimes get like a carbonated espresso drink. So, then is that a soda? Mhm, that's a great question. Yeah, and Gabe has a good thought too about maybe it was pulling stock footage of where the dog breeds are from instead of the dogs themselves. I am not the dog expert. So, if you are in the chat, you can tell us. Maybe it was a geography reference. Maybe. And then um actually one thing before I forget also is I want to show off our API docs um because they show the functionality that if you're somebody savvy with the CLI or contacting the API directly is already active in live for people and is coming to the MCP very soon. Um So, over here, we know this has been really popular request is publishing projects. So, now with the API and the CLI, you can actually publish your projects and without having to be in descript. com, you can create Descript share links and we're actively working on also publishing transcripts cuz we've heard from people that that's really popular and really needed for your work. And then you can also list your projects and get project details. So, the idea here is if you're like, "Hmm, there's this project I worked on. I think it was in April. It's owned by Sam. I don't remember exactly what the title was. " You can just talk to Claude and Claude should be able to pull it for you. And for people who aren't familiar, Teddy, what's the difference with being in the CLI or maybe even what is that stand for cuz I'm not sure. I'm not a developer or coder. That's totally fair. Um so, the CLI stands for command line interface. And basically, it's a way for you to talk through usually your terminal app on your computer directly to our servers. So, you can see I can pull this over actually. So, well, um this may look like just a wall of text. But, the important thing here is this part where basically through this Descript API command just on my computer, I'm talking directly to Descript's API and the API servers. And this is helpful for folks who are technically savvy enough that it's actually faster for you to do things in the terminal versus talking to Claude. Or if you want to build your own app that connects to Descript, this is how you would do it. And so, just here yesterday, you can see I was doing a list of projects trying to find out what are different projects I've made in the past week. Up here was a bunch of projects I made in the past month. Just trying to see, "Okay, where's my project that I was looking for, you know? " And so, don't worry if this all looks really overwhelming and just kind of makes your eyes glaze over because this will be in the MCP very soon. And aren't there some AI tools you can plug into your terminal now that you don't have to manually enter commands and use the proper syntax and formatting? Exactly. And like I could honestly I could even ask Claude. I could say, "I want to use the Descript CLI

### [25:00](https://www.youtube.com/watch?v=gfhW_tVJRDg&t=1500s) Segment 6 (25:00 - 30:00)

CLI to list all my projects. Use the API docs here to give me step by step how to do that. " And then I could even say, "I am not an engineer. Keep it friendly for someone who is Let's pretend I'm a journalist. " And then Claude should actually be able to analyze our documents here that I was sharing and tell you very simply like, "This is what you're going to do, one, two, three. " And that way even things that we don't necessarily have in the MCP yet just because we want to make sure that it's good before we put it in the MCP since those connections are a little different than the CLI. Claude can still help you get what you need and get to try our latest and greatest features. Yeah, and if you're somebody who's been intimidated by a terminal, I'm raising my own hand cuz I'm not a technical person. I've learned if you have a tool like Teddy's showing you, it's more copying and pasting the right thing than knowing what to type in manually. And some like Claude code can even just run in your terminal and do it for you. Yes. And you know, what's really funny is like Claude is so good that me and a lot of the engineers, honestly, sometimes when I'm in the terminal and I'm like, "I don't know what just happened. " I just copy and paste, drop it into Claude and tell and say, "What went wrong? Help me fix it. " And Claude is able to get me unblocked like 90% of the time. Yeah, so like Gemini CLI, Codex CLI, there's pretty much all of them can work in your terminal now. Yeah, exactly. So, if you ever see anything that we show here in the docs, but you're like, "This doesn't work in the MCP yet. " That's okay. Give it a try working with Claude to use the docs to get you what you need. Cuz if you started a project in the MCP, say like you did in a Claude chat, could you pass the link to it through your terminal and do some other things in that same project? Yeah, you definitely could. Okay, uh couple questions here as we're running up against the end of the time slot. What's the best way to keep track of changes with the API? Mhm. That's a great question. So, I think right now, because we're in beta, we're not actively publishing changes to the API docs. When we're in GA, we definitely will be doing that. So, I think the best way would be you could either check yourself. You could also actually write a little Claude out workflow to just check on some frequency of, "Hey, have there been changes? " Um and then let you know when there have been changes done to the API docs. Yes, something I did with the Claude project as I brought in the API docs. And if you've done that before, you could just paste in the link and say, "Tell me what's different from the first version. " Um you can also see those connectors if you weren't on earlier when Teddy set the MCP up, it'll show you all the permissions. And there's what, double the number of them now than when this first came out? Exactly. Like out, we only had import media, Underlord, and then some stuff around like jobs like canceling the job if you want to stop it. Um now you can see we've got publish project, we've got list jobs, and all this other stuff. So, that's also a good way to check is um if you look at your connector and you're like, "Hey, there's a bunch of stuff here that wasn't there before. " Yeah, and then Gabe got the support link shared, but what other input would you seek from somebody like Brian on LinkedIn who's asking about reporting bugs or telling us what they're having issues with? So, this is a great question cuz especially since we're in the beta phase right now, we want to hear all the bug reports. Um and there's a couple different channels. So, you could use the support link that Gabe sent in the chat. You can also join our Discord and talk with our community because somebody might have also seen that same bug. And the more information we can get about a bug, the better it we're able to solve it. You can also um I believe you can also comment on any of these live streams and we can help you out getting that into our actual bug filing tools or just send us an email at any time. There's a lot of different channels to contact us and we definitely want to hear your feedback, whatever you've got, and take seriously bugs that our customers find. Yeah, and if anybody has a last question here for Teddy before we wrap up, even if it's a does it work with my tool or my coding agent. Mhm. We would love to get that answered while we are live on the stream. Otherwise, you can check the API docs and if you don't want to read them or aren't sure

### [30:00](https://www.youtube.com/watch?v=gfhW_tVJRDg&t=1800s) Segment 7 (30:00 - 33:00)

just pass them to your GPT or Claude tool and it should be able to tell you what you can do with it. Yes, exactly. Yeah, and as we wrap up Teddy any new cool use cases even if they're the wild and weird and maybe less practical. Like what what's the most interesting thing you've seen someone make internally or externally with the API? This is a good question because it's so hard to choose honestly because I've seen so many different things people do. One that comes right to mind for me is somebody made a Zapier app where they create shared Dropbox or Google Drive folder. They can share with their family when they all go on vacation and have everybody upload their vacation photos. And then that gets piped into Descript to make a little vacation video that then they can share with the whole family. And this is on my mind because last weekend I was at the Getty Villa with my mom and sister and my mom took all the photos and I forgot to ask her for all of them — and I keep forgetting to go back and ask her for all those photos. Yeah, so you could just share the Google Drive with whoever's on the trip with you and they don't even have to mess with anything. You could have all the automations through Zapier go to Descript projects. Exactly. Yeah, that's great. The most recent one I did was using the API office hours with the API which felt very meta and not relevant to anyone else on earth but me but it was still fun. Yeah, well we are at time. Which means we're going to go back to this view and there we go. Here is the QR code to our Discord server. If you're not in there yet, you should be able to scan this here. And once you join you'll see the channels on the side. There's a key emoji and there's an API channel. That's specifically for if you have an issue, a cool thing you want to share, a bug report, AI credit question, any of those. Gabe and I will be in that Discord channel. And you will also see other people using the API, other early access testers and kind of the collective knowledge base is being built there. And then if you have questions on whether it's API or anything Descript you can go to help. descript. com and there is going to be an article that can show you with screenshots and visuals how to use a feature or get something set up on your end. So, we want to see what you make. You if you put things out on socials or your YouTube channel, you can tag us. We're at Descript on most of those channels and we will engage with your content whether it's with the API or not. Teddy, thank you for walking us through the two different videos and how to get everything set up with the Descript API today. Yeah, thank you for having me. Yes, and this will be on YouTube for anybody who came in late. We will be here same time, same place next Friday maybe with some new features. Mhm, hopefully. We'll see. Yes, have a great weekend everybody. Bye.

---
*Источник: https://ekstraktznaniy.ru/video/46273*